/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / BBS / HERMES / HemresEx.cpt / HEI 1.0.7 / User Externals Docs

< prev

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 13 55 73 65 72 20 45 | 78 74 65 72 6e 61 6c 73 |..User E|xternals|
|00000010| 20 44 6f 63 73 00 00 00 | 00 00 00 00 00 00 00 00 | Docs...|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 57 4f 52 44 4d 41 43 | 41 00 00 00 00 00 00 00 |.WORDMAC|A.......|
|00000050| 00 00 00 00 00 7e 7e 00 | 00 02 da a3 b6 83 a7 a3 |.....~~.|........|
|00000060| b6 83 a7 00 00 06 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 52 b4 00 00 |........|....R...|
|00000080| 00 06 00 c5 00 02 00 02 | 00 8b 00 00 00 ff 00 02 |........|........|
|00000090| 00 01 00 00 7e 76 00 08 | 00 08 00 04 01 db 02 7b |....~v..|.......{|
|000000a0| 00 00 00 00 00 00 00 00 | 00 03 00 00 00 48 00 48 |........|.....H.H|
|000000b0| 00 00 00 00 02 da 02 28 | ff e1 ff e2 02 f9 02 46 |.......(|.......F|
|000000c0| 03 47 05 28 03 fc 00 02 | 00 00 00 48 00 48 00 00 |.G.(....|...H.H..|
|000000d0| 00 00 02 da 02 28 00 01 | 00 00 00 64 00 00 00 01 |.....(..|...d....|
|000000e0| 00 01 01 01 00 00 00 01 | 27 0f 00 01 00 01 00 00 |........|'.......|
|000000f0| 00 00 00 00 00 00 00 00 | 00 00 00 0a 00 19 01 90 |........|........|
|00000100| 00 00 00 00 00 40 00 00 | 00 00 00 00 00 00 00 01 |.....@..|........|
|00000110| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000120| 00 01 00 00 00 01 00 00 | 00 00 00 01 00 00 01 5c |........|.......\|
|00000130| 00 20 00 00 01 56 00 06 | ff f2 00 1e ff f2 00 c2 |. ...V..|........|
|00000140| ff f2 01 90 00 00 00 00 | ff ff 0c 00 00 03 00 01 |........|........|
|00000150| 00 00 00 01 00 00 00 00 | 00 01 00 00 01 ae 00 20 |........|....... |
|00000160| 00 00 01 a8 00 06 ff f2 | 00 1e ff f2 00 c2 ff f2 |........|........|
|00000170| 01 90 00 00 00 00 ff ff | 0c 00 00 03 00 01 00 00 |........|........|
|00000180| 00 01 00 00 00 00 00 01 | 00 00 72 26 0c 50 00 00 |........|..r&.P..|
|00000190| 6f 2a 02 fc ff f2 00 1e | ff f2 00 c2 ff ff ff ff |o*......|........|
|000001a0| 00 00 00 00 ff ff 18 01 | 00 15 00 09 01 dd 00 01 |........|........|
|000001b0| 00 00 00 09 01 44 80 05 | 88 b8 00 66 ef d0 00 00 |.....D..|...f....|
|000001c0| 00 01 00 00 3c dc 00 6f | d9 8e 00 02 00 00 00 06 |....<..o|........|
|000001d0| 00 00 0c 00 00 03 00 00 | 00 01 10 00 00 00 00 00 |........|........|
|000001e0| 00 00 00 00 00 00 01 2a | 00 22 00 00 00 10 00 00 |.......*|."......|
|000001f0| 00 00 00 00 00 00 01 4c | 00 0a 33 01 00 09 01 dd |.......L|..3.....|
|00000200| 00 01 00 00 00 09 01 44 | 80 05 88 b8 00 66 ef d0 |.......D|.....f..|
|00000210| 00 00 00 01 00 00 3c dc | 00 6f d9 8e 00 02 00 00 |......<.|.o......|
|00000220| 00 06 00 00 0c 00 00 03 | 00 00 00 01 10 00 00 00 |........|........|
|00000230| 00 00 00 00 00 00 00 00 | 01 7c 00 22 00 00 00 10 |........|.|."....|
|00000240| 00 00 00 00 00 00 00 00 | 01 9e 00 0a 33 01 00 00 |........|....3...|
|00000250| 01 da 01 00 00 00 00 00 | 88 b4 4e f9 00 70 39 6e |........|..N..p9n|
|00000260| 02 94 00 00 00 18 00 63 | 88 b4 00 00 ff ff ff ff |.......c|........|
|00000270| 00 1c 55 73 65 72 20 45 | 78 74 65 72 6e 61 6c 20 |..User E|xternal |
|00000280| 44 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 0d 00 06 |Document|ation...|
|00000290| 00 00 18 01 00 15 00 17 | 45 78 74 65 72 6e 61 6c |........|External|
|000002a0| 73 20 44 6f 63 73 20 50 | 61 72 74 20 49 49 0d ff |s Docs P|art II..|
|000002b0| 00 06 00 00 18 01 00 15 | 00 12 48 65 72 6d 65 73 |........|..Hermes|
|000002c0| 20 42 42 53 20 76 31 2e | 30 2e 37 0d 00 06 00 00 | BBS v1.|0.7.....|
|000002d0| 12 00 00 15 00 14 62 79 | 20 46 72 61 6e 6b 20 50 |......by| Frank P|
|000002e0| 72 69 63 65 2c 20 49 49 | 49 0d 00 06 00 00 0c 00 |rice, II|I.......|
|000002f0| 00 15 00 2b 48 65 72 6d | 65 73 20 69 73 20 a9 31 |...+Herm|es is .1|
|00000300| 39 38 39 2d 31 39 39 31 | 20 62 79 20 41 4f 43 20 |989-1991| by AOC |
|00000310| 53 6f 66 74 77 61 72 65 | 2c 20 49 6e 63 2e 0d ff |Software|, Inc...|
|00000320| 00 06 00 00 0c 00 00 15 | 00 0c 46 69 72 73 74 20 |........|..First |
|00000330| 44 72 61 66 74 0d 00 06 | 00 00 0c 00 00 15 00 27 |Draft...|.......'|
|00000340| 43 61 6c 6c 20 74 68 65 | 20 73 75 70 70 6f 72 74 |Call the| support|
|00000350| 20 42 42 53 2e 2e 2e 2e | 2e 28 32 31 33 29 32 37 | BBS....|.(213)27|
|00000360| 35 2d 36 39 37 35 0d ff | 00 06 00 00 0c 00 00 15 |5-6975..|........|
|00000370| 00 01 0d ff 00 06 00 00 | 0c 00 00 15 00 0d 49 6e |........|......In|
|00000380| 74 72 6f 64 75 63 74 69 | 6f 6e 0d ff 00 06 00 00 |troducti|on......|
|00000390| 0c 01 00 0e 00 00 01 da | 00 00 00 00 00 00 00 24 |........|.......$|
|000003a0| 00 63 88 b4 00 00 00 00 | 00 00 00 00 00 08 aa ac |.c......|........|
|000003b0| 00 00 ff ff ff ff 02 88 | 57 72 69 74 69 6e 67 20 |........|Writing |
|000003c0| 75 73 65 72 20 65 78 74 | 65 72 6e 61 6c 73 20 63 |user ext|ernals c|
|000003d0| 61 6e 20 62 65 20 73 69 | 6d 70 6c 65 20 61 6e 64 |an be si|mple and|
|000003e0| 20 69 74 20 63 61 6e 20 | 62 65 20 76 65 72 79 20 | it can |be very |
|000003f0| 64 69 66 66 69 63 75 6c | 74 20 64 65 70 65 6e 64 |difficul|t depend|
|00000400| 69 6e 67 20 6f 6e 20 77 | 68 61 74 20 79 6f 75 20 |ing on w|hat you |
|00000410| 61 72 65 20 64 6f 69 6e | 67 2e 20 20 54 68 65 20 |are doin|g.  The |
|00000420| 70 6f 73 73 69 62 69 6c | 69 74 69 65 73 20 61 72 |possibil|ities ar|
|00000430| 65 20 61 62 73 6f 6c 75 | 74 65 6c 79 20 65 6e 64 |e absolu|tely end|
|00000440| 6c 65 73 73 20 6f 66 20 | 77 68 61 74 20 79 6f 75 |less of |what you|
|00000450| 20 63 6f 75 6c 64 20 64 | 6f 20 77 69 74 68 20 74 | could d|o with t|
|00000460| 68 69 73 20 69 6e 74 65 | 72 66 61 63 65 2e 20 20 |his inte|rface.  |
|00000470| 53 6f 75 72 63 65 20 63 | 6f 64 65 20 68 61 73 20 |Source c|ode has |
|00000480| 62 65 65 6e 20 69 6e 63 | 6c 75 64 65 64 20 77 69 |been inc|luded wi|
|00000490| 74 68 20 74 68 69 73 20 | 64 6f 63 75 6d 65 6e 74 |th this |document|
|000004a0| 20 66 6f 72 20 61 20 76 | 65 72 79 20 73 6d 61 6c | for a v|ery smal|
|000004b0| 6c 20 65 78 61 6d 70 6c | 65 20 65 78 74 65 72 6e |l exampl|e extern|
|000004c0| 61 6c 20 77 68 69 63 68 | 20 61 6c 6c 6f 77 73 20 |al which| allows |
|000004d0| 75 73 65 72 73 20 74 6f | 20 63 68 61 6e 67 65 20 |users to| change |
|000004e0| 74 68 65 69 72 20 70 68 | 6f 6e 65 20 6e 75 6d 62 |their ph|one numb|
|000004f0| 65 72 2e 20 20 49 74 20 | 64 6f 65 73 20 6e 6f 74 |er.  It |does not|
|00000500| 68 69 6e 67 20 73 70 65 | 63 69 61 6c 2e 20 20 49 |hing spe|cial.  I|
|00000510| 74 20 64 6f 65 73 6e d5 | 74 20 68 6f 6f 6b 20 69 |t doesn.|t hook i|
|00000520| 6e 74 6f 20 61 20 6d 61 | 69 6e 20 6d 65 6e 75 20 |nto a ma|in menu |
|00000530| 63 6f 6d 6d 61 6e 64 2c | 20 62 75 74 20 75 73 65 |command,| but use|
|00000540| 73 20 74 68 65 20 73 74 | 61 6e 64 61 72 64 20 65 |s the st|andard e|
|00000550| 78 74 65 72 6e 61 6c 73 | 20 6d 65 6e 75 20 66 6f |xternals| menu fo|
|00000560| 72 20 61 63 63 65 73 73 | 2e 20 20 54 68 69 73 20 |r access|.  This |
|00000570| 69 73 20 6a 75 73 74 20 | 6f 6e 65 20 6f 66 20 6d |is just |one of m|
|00000580| 61 6e 79 20 77 61 79 73 | 20 79 6f 75 72 20 65 78 |any ways| your ex|
|00000590| 74 65 72 6e 61 6c 20 63 | 61 6e 20 62 65 20 61 63 |ternal c|an be ac|
|000005a0| 63 65 73 73 65 64 2e 20 | 20 46 6f 72 20 74 68 65 |cessed. | For the|
|000005b0| 20 6d 6f 73 74 20 70 61 | 72 74 2c 20 79 6f 75 20 | most pa|rt, you |
|000005c0| 63 61 6e 20 64 6f 20 61 | 6e 79 74 68 69 6e 67 20 |can do a|nything |
|000005d0| 74 68 61 74 20 49 20 6d | 79 73 65 6c 66 20 63 6f |that I m|yself co|
|000005e0| 75 6c 64 20 64 6f 20 69 | 6e 73 69 64 65 20 48 65 |uld do i|nside He|
|000005f0| 72 6d 65 73 2e 20 20 48 | 6f 77 65 76 65 72 2c 20 |rmes.  H|owever, |
|00000600| 74 68 69 73 20 69 73 20 | 6c 69 6d 69 74 65 64 20 |this is |limited |
|00000610| 62 79 20 73 65 76 65 72 | 61 6c 20 69 73 73 75 65 |by sever|al issue|
|00000620| 73 20 77 68 69 63 68 20 | 77 65 20 77 69 6c 6c 20 |s which |we will |
|00000630| 66 69 6e 64 20 6f 75 74 | 20 61 62 6f 75 74 2e 0d |find out| about..|
|00000640| 00 12 00 00 0c 00 00 0e | 01 00 0c 00 00 0e 02 00 |........|........|
|00000650| 0c 00 00 0e 00 01 0d ff | 00 06 00 00 0c 00 00 0e |........|........|
|00000660| 00 00 01 da 01 00 00 00 | 00 00 aa ac 00 00 00 00 |........|........|
|00000670| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 ff ff |........|........|
|00000680| ff ff 00 07 42 61 73 69 | 63 73 0d ff 00 06 00 00 |....Basi|cs......|
|00000690| 0c 01 00 0e 00 00 01 da | 00 00 00 00 00 00 aa ac |........|........|
|000006a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000006b0| 00 00 ff ff ff ff 03 bc | 53 79 73 6f 70 20 65 78 |........|Sysop ex|
|000006c0| 74 65 72 6e 61 6c 73 20 | 61 6e 64 20 75 73 65 72 |ternals |and user|
|000006d0| 20 65 78 74 65 72 6e 61 | 6c 73 20 61 72 65 20 74 | externa|ls are t|
|000006e0| 77 6f 20 64 69 66 66 65 | 72 65 6e 74 20 62 65 61 |wo diffe|rent bea|
|000006f0| 73 74 73 2e 20 20 54 68 | 65 79 20 6d 75 73 74 20 |sts.  Th|ey must |
|00000700| 62 65 20 63 6f 6d 70 69 | 6c 65 64 20 73 65 70 61 |be compi|led sepa|
|00000710| 72 61 74 65 6c 79 20 61 | 6e 64 20 74 68 65 79 20 |rately a|nd they |
|00000720| 61 72 65 20 63 61 6c 6c | 65 64 20 64 69 66 66 65 |are call|ed diffe|
|00000730| 72 65 6e 74 6c 79 20 62 | 79 20 48 65 72 6d 65 73 |rently b|y Hermes|
|00000740| 2e 20 20 42 75 74 20 74 | 68 65 20 65 78 74 65 72 |.  But t|he exter|
|00000750| 6e 61 6c 20 66 69 6c 65 | 20 74 68 61 74 20 69 73 |nal file| that is|
|00000760| 20 75 73 65 64 20 62 79 | 20 73 79 73 6f 70 20 65 | used by| sysop e|
|00000770| 78 74 65 72 6e 61 6c 73 | 20 6d 61 79 20 61 6c 73 |xternals| may als|
|00000780| 6f 20 63 6f 6e 74 61 69 | 6e 20 61 20 75 73 65 72 |o contai|n a user|
|00000790| 20 65 78 74 65 72 6e 61 | 6c 2e 20 20 57 68 65 72 | externa|l.  Wher|
|000007a0| 65 61 73 20 74 68 65 20 | 73 79 73 6f 70 20 65 78 |eas the |sysop ex|
|000007b0| 74 65 72 6e 61 6c 20 63 | 6f 64 65 20 69 73 20 63 |ternal c|ode is c|
|000007c0| 6f 6e 74 61 69 6e 65 64 | 20 69 6e 20 61 20 72 65 |ontained| in a re|
|000007d0| 73 6f 75 72 63 65 20 6f | 66 20 74 79 70 65 20 d4 |source o|f type .|
|000007e0| 58 48 52 4d d5 20 49 44 | 3d 31 30 30 30 30 2c 20 |XHRM. ID|=10000, |
|000007f0| 61 20 75 73 65 72 20 65 | 78 74 65 72 6e 61 6c 20 |a user e|xternal |
|00000800| 69 73 20 61 6e 20 d4 58 | 48 52 4d d5 20 49 44 3d |is an .X|HRM. ID=|
|00000810| 31 30 30 30 31 2e 20 20 | 41 6e 20 65 78 61 6d 70 |10001.  |An examp|
|00000820| 6c 65 20 6f 66 20 61 6e | 20 65 78 74 65 72 6e 61 |le of an| externa|
|00000830| 6c 20 74 68 61 74 20 68 | 61 73 20 6e 6f 20 73 79 |l that h|as no sy|
|00000840| 73 6f 70 20 65 78 74 65 | 72 6e 61 6c 20 61 73 73 |sop exte|rnal ass|
|00000850| 6f 63 69 61 74 65 64 20 | 77 69 74 68 20 69 74 20 |ociated |with it |
|00000860| 69 73 20 74 68 65 20 55 | 70 64 61 74 65 20 50 68 |is the U|pdate Ph|
|00000870| 6f 6e 65 20 65 78 74 65 | 72 6e 61 6c 2e 20 20 41 |one exte|rnal.  A|
|00000880| 6e 20 65 78 61 6d 70 6c | 65 20 6f 66 20 61 20 73 |n exampl|e of a s|
|00000890| 79 73 6f 70 20 65 78 74 | 65 72 6e 61 6c 20 77 69 |ysop ext|ernal wi|
|000008a0| 74 68 20 6e 6f 20 75 73 | 65 72 20 65 78 74 65 72 |th no us|er exter|
|000008b0| 6e 61 6c 20 69 73 20 74 | 68 65 20 4f 70 74 69 6f |nal is t|he Optio|
|000008c0| 6e 73 20 65 78 74 65 72 | 6e 61 6c 2e 20 20 49 66 |ns exter|nal.  If|
|000008d0| 20 77 65 20 77 65 72 65 | 20 74 6f 20 63 6f 6d 62 | we were| to comb|
|000008e0| 69 6e 65 20 74 68 65 73 | 65 20 74 77 6f 20 65 78 |ine thes|e two ex|
|000008f0| 74 65 72 6e 61 6c 73 20 | 61 73 20 63 61 6e 20 65 |ternals |as can e|
|00000900| 61 73 69 6c 79 20 62 65 | 20 64 6f 6e 65 2c 20 77 |asily be| done, w|
|00000910| 65 20 63 6f 75 6c 64 20 | 63 72 65 61 74 65 20 71 |e could |create q|
|00000920| 75 69 74 65 20 70 6f 77 | 65 72 66 75 6c 20 63 68 |uite pow|erful ch|
|00000930| 61 6e 67 65 73 20 74 6f | 20 48 65 72 6d 65 73 2e |anges to| Hermes.|
|00000940| 20 20 54 68 65 20 75 73 | 65 72 20 63 6f 64 65 20 |  The us|er code |
|00000950| 66 6f 72 20 47 46 69 6c | 65 73 20 69 73 20 69 6e |for GFil|es is in|
|00000960| 74 65 72 6e 61 6c 20 69 | 6e 20 48 65 72 6d 65 73 |ternal i|n Hermes|
|00000970| 2e 20 20 54 68 69 73 20 | 69 73 20 62 65 63 61 75 |.  This |is becau|
|00000980| 73 65 20 69 74 20 77 61 | 73 20 70 72 6f 67 72 61 |se it wa|s progra|
|00000990| 6d 6d 65 64 20 62 65 66 | 6f 72 65 20 74 68 65 20 |mmed bef|ore the |
|000009a0| 75 73 65 72 20 65 78 74 | 65 72 6e 61 6c 20 69 6e |user ext|ernal in|
|000009b0| 74 65 72 66 61 63 65 20 | 77 61 73 20 66 69 6e 69 |terface |was fini|
|000009c0| 73 68 65 64 2e 20 20 42 | 75 74 20 69 66 20 69 74 |shed.  B|ut if it|
|000009d0| 20 77 61 73 6e d5 74 2c | 20 77 65 20 63 6f 75 6c | wasn.t,| we coul|
|000009e0| 64 20 6d 61 6b 65 20 73 | 6f 6d 65 74 68 69 6e 67 |d make s|omething|
|000009f0| 20 65 78 61 63 74 6c 79 | 20 74 68 65 20 73 61 6d | exactly| the sam|
|00000a00| 65 20 63 6f 6d 70 6c 65 | 74 65 6c 79 20 65 78 74 |e comple|tely ext|
|00000a10| 65 72 6e 61 6c 2e 20 20 | 54 68 65 20 6e 65 63 65 |ernal.  |The nece|
|00000a20| 73 73 61 72 79 20 72 65 | 73 6f 75 72 63 65 73 20 |ssary re|sources |
|00000a30| 66 6f 72 20 61 20 48 65 | 72 6d 65 73 20 65 78 74 |for a He|rmes ext|
|00000a40| 65 72 6e 61 6c 20 66 69 | 6c 65 20 74 6f 20 62 65 |ernal fi|le to be|
|00000a50| 20 72 65 63 6f 67 6e 69 | 7a 65 64 20 61 73 20 61 | recogni|zed as a|
|00000a60| 20 75 73 65 72 20 65 78 | 74 65 72 6e 61 6c 20 61 | user ex|ternal a|
|00000a70| 72 65 3a 0d 00 18 00 00 | 0c 00 00 0e 01 00 0c 00 |re:.....|........|
|00000a80| 00 0e 02 00 0c 00 00 0e | 03 00 0c 00 00 0e 00 01 |........|........|
|00000a90| 0d ff 00 06 00 00 0c 00 | 00 0e 00 1d 09 58 48 52 |........|.....XHR|
|00000aa0| 4d 2c 20 31 30 30 30 31 | 20 20 20 43 6f 64 65 20 |M, 10001|   Code |
|00000ab0| 72 65 73 6f 75 72 63 65 | 0d ff 00 12 00 00 0c 00 |resource|........|
|00000ac0| 00 0e 00 01 0c 01 00 0e | 00 0c 0c 00 00 0e 00 1f |........|........|
|00000ad0| 09 48 52 4d 53 2c 20 31 | 30 30 20 20 49 6e 66 6f |.HRMS, 1|00  Info|
|00000ae0| 72 6d 61 74 69 6f 6e 20 | 72 65 63 6f 72 64 0d ff |rmation |record..|
|00000af0| 00 12 00 00 0c 00 00 0e | 00 01 0c 01 00 0e 00 0a |........|........|
|00000b00| 0c 00 00 0e 00 01 0d ff | 00 06 00 00 0c 00 00 0e |........|........|
|00000b10| 01 28 41 6c 73 6f 2c 20 | 61 73 20 73 74 61 74 65 |.(Also, |as state|
|00000b20| 64 20 69 6e 20 74 68 65 | 20 73 79 73 6f 70 20 65 |d in the| sysop e|
|00000b30| 78 74 65 72 6e 61 6c 20 | 64 6f 63 73 2c 20 74 68 |xternal |docs, th|
|00000b40| 65 20 66 69 6c 65 20 6d | 75 73 74 20 62 65 20 6f |e file m|ust be o|
|00000b50| 66 20 74 79 70 65 20 d2 | 58 48 52 4d d3 20 61 6e |f type .|XHRM. an|
|00000b60| 64 20 63 72 65 61 74 6f | 72 20 d2 48 52 4d 53 d3 |d creato|r .HRMS.|
|00000b70| 2e 20 20 41 20 66 69 6c | 65 20 63 61 6e 20 68 61 |.  A fil|e can ha|
|00000b80| 76 65 20 62 6f 74 68 20 | 61 20 73 79 73 6f 70 20 |ve both |a sysop |
|00000b90| 65 78 74 65 72 6e 61 6c | 20 61 6e 64 20 61 20 75 |external| and a u|
|00000ba0| 73 65 72 20 65 78 74 65 | 72 6e 61 6c 2c 20 6f 72 |ser exte|rnal, or|
|00000bb0| 20 65 69 74 68 65 72 20 | 6f 6e 65 2e 20 20 42 75 | either |one.  Bu|
|00000bc0| 74 20 69 74 20 6d 75 73 | 74 20 6d 65 65 74 20 74 |t it mus|t meet t|
|00000bd0| 68 65 73 65 20 63 6f 6e | 64 69 74 69 6f 6e 73 2e |hese con|ditions.|
|00000be0| 20 20 57 68 65 6e 20 70 | 6c 61 63 65 64 20 69 6e |  When p|laced in|
|00000bf0| 20 74 68 65 20 45 78 74 | 65 72 6e 61 6c 73 20 66 | the Ext|ernals f|
|00000c00| 6f 6c 64 65 72 2c 20 48 | 65 72 6d 65 73 20 77 69 |older, H|ermes wi|
|00000c10| 6c 6c 20 61 75 74 6f 6d | 61 74 69 63 61 6c 6c 79 |ll autom|atically|
|00000c20| 20 72 65 63 6f 67 6e 69 | 7a 65 20 69 74 20 6f 6e | recogni|ze it on|
|00000c30| 20 73 74 61 72 74 75 70 | 2e 0d 00 0c 00 00 0c 00 | startup|........|
|00000c40| 00 0e 01 00 0c 00 00 0e | 00 01 0d ff 00 06 00 00 |........|........|
|00000c50| 0c 00 00 0e 00 01 0d ff | 00 06 00 00 0c 00 00 0e |........|........|
|00000c60| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 01 0d ff |........|........|
|00000c70| 00 06 00 00 0c 00 00 0e | 00 01 0d ff 00 06 00 00 |........|........|
|00000c80| 0c 00 00 0e 00 01 0d ff | 00 06 00 00 0c 00 00 0e |........|........|
|00000c90| 00 00 01 da 01 00 00 00 | 00 00 aa ac 00 00 00 00 |........|........|
|00000ca0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 ff ff |........|........|
|00000cb0| ff ff 00 16 54 68 65 20 | 48 52 4d 53 20 31 30 30 |....The |HRMS 100|
|00000cc0| 20 52 65 73 6f 75 72 63 | 65 0d 00 06 00 00 0c 01 | Resourc|e.......|
|00000cd0| 00 0e 00 00 01 da 00 00 | 00 00 00 00 aa ac 00 00 |........|........|
|00000ce0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000cf0| ff ff ff ff 00 6b 49 6e | 20 50 61 73 63 61 6c 2c |.....kIn| Pascal,|
|00000d00| 20 74 68 65 20 73 74 72 | 75 63 74 75 72 65 20 66 | the str|ucture f|
|00000d10| 6f 72 20 74 68 65 20 48 | 52 4d 53 20 49 44 3d 31 |or the H|RMS ID=1|
|00000d20| 30 30 20 72 65 73 6f 75 | 72 63 65 20 74 68 61 74 |00 resou|rce that|
|00000d30| 20 6d 75 73 74 20 61 63 | 63 6f 6d 70 61 6e 79 20 | must ac|company |
|00000d40| 61 6e 79 20 75 73 65 72 | 20 65 78 74 65 72 6e 61 |any user| externa|
|00000d50| 6c 20 69 73 20 61 73 20 | 66 6f 6c 6c 6f 77 73 3a |l is as |follows:|
|00000d60| 0d ff 00 06 00 00 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|00000d70| 00 00 0a 00 00 0e 00 12 | 65 49 6e 66 6f 52 65 63 |........|eInfoRec|
|00000d80| 20 3d 20 72 65 63 6f 72 | 64 0d 00 06 00 00 09 00 | = recor|d.......|
|00000d90| 00 03 00 17 20 20 20 20 | 20 61 6c 6c 54 69 6d 65 |....    | allTime|
|00000da0| 3a 20 62 6f 6f 6c 65 61 | 6e 3b 0d ff 00 06 00 00 |: boolea|n;......|
|00000db0| 09 00 00 03 00 1c 20 20 | 20 20 20 6d 69 6e 53 4c |......  |   minSL|
|00000dc0| 66 6f 72 4d 65 6e 75 3a | 20 69 6e 74 65 67 65 72 |forMenu:| integer|
|00000dd0| 3b 0d 00 06 00 00 09 00 | 00 03 00 18 20 20 20 20 |;.......|....    |
|00000de0| 20 52 65 73 74 72 69 63 | 74 69 6f 6e 3a 20 63 68 | Restric|tion: ch|
|00000df0| 61 72 3b 0d 00 06 00 00 | 09 00 00 03 00 09 20 20 |ar;.....|......  |
|00000e00| 20 20 65 6e 64 3b 0d ff | 00 06 00 00 09 00 00 03 |  end;..|........|
|00000e10| 00 01 0d ff 00 06 00 00 | 09 00 00 03 01 01 54 68 |........|......Th|
|00000e20| 69 73 20 72 65 63 6f 72 | 64 20 69 73 20 61 6c 73 |is recor|d is als|
|00000e30| 6f 20 63 6f 6e 74 61 69 | 6e 65 64 20 69 6e 20 74 |o contai|ned in t|
|00000e40| 68 65 20 48 65 72 6d 48 | 65 61 64 65 72 73 2e 70 |he HermH|eaders.p|
|00000e50| 20 66 69 6c 65 20 64 69 | 73 74 72 69 62 75 74 65 | file di|stribute|
|00000e60| 64 20 77 69 74 68 20 74 | 68 69 73 20 64 6f 63 75 |d with t|his docu|
|00000e70| 6d 65 6e 74 2e 20 20 59 | 6f 75 20 63 61 6e 20 65 |ment.  Y|ou can e|
|00000e80| 69 74 68 65 72 20 70 72 | 6f 67 72 61 6d 20 61 20 |ither pr|ogram a |
|00000e90| 73 79 73 6f 70 20 65 78 | 74 65 72 6e 61 6c 20 74 |sysop ex|ternal t|
|00000ea0| 6f 20 66 69 6c 6c 20 74 | 68 65 20 66 69 65 6c 64 |o fill t|he field|
|00000eb0| 73 20 6f 66 20 74 68 69 | 73 20 72 65 63 6f 72 64 |s of thi|s record|
|00000ec0| 20 77 69 74 68 20 74 68 | 65 20 64 65 73 69 72 65 | with th|e desire|
|00000ed0| 64 20 76 61 6c 75 65 73 | 20 6f 72 20 73 65 74 20 |d values| or set |
|00000ee0| 74 68 65 6d 20 6d 61 6e | 75 61 6c 6c 79 2e 20 20 |them man|ually.  |
|00000ef0| 41 20 64 65 66 69 6e 69 | 74 69 6f 6e 20 6f 66 20 |A defini|tion of |
|00000f00| 74 68 65 73 65 20 66 69 | 65 6c 64 73 20 69 73 20 |these fi|elds is |
|00000f10| 69 6e 20 6f 72 64 65 72 | 20 68 65 72 65 3a 0d ff |in order| here:..|
|00000f20| 00 0c 00 00 0c 00 00 0e | 01 00 0c 00 00 0e 00 01 |........|........|
|00000f30| 0d ff 00 06 00 00 0c 00 | 00 0e 02 d9 61 6c 6c 54 |........|....allT|
|00000f40| 69 6d 65 3a 20 57 68 65 | 6e 20 74 72 75 65 2c 20 |ime: Whe|n true, |
|00000f50| 74 68 65 20 65 78 74 65 | 72 6e 61 6c 20 77 69 6c |the exte|rnal wil|
|00000f60| 6c 20 62 65 20 63 61 6c | 6c 65 64 20 6f 6e 20 65 |l be cal|led on e|
|00000f70| 76 65 72 79 20 73 69 6e | 67 6c 65 20 75 73 65 72 |very sin|gle user|
|00000f80| 20 69 64 6c 65 20 6c 6f | 6f 70 20 69 6e 20 48 65 | idle lo|op in He|
|00000f90| 72 6d 65 73 2e 20 20 54 | 68 69 73 20 66 65 61 74 |rmes.  T|his feat|
|00000fa0| 75 72 65 20 77 69 6c 6c | 20 62 65 20 65 78 70 6c |ure will| be expl|
|00000fb0| 61 69 6e 65 64 20 6d 6f | 72 65 20 6c 61 74 65 72 |ained mo|re later|
|00000fc0| 2e 20 20 49 66 20 79 6f | 75 20 65 78 74 65 72 6e |.  If yo|u extern|
|00000fd0| 61 6c 20 64 6f 65 73 20 | 6e 6f 74 68 69 6e 67 20 |al does |nothing |
|00000fe0| 62 65 79 6f 6e 64 20 67 | 65 74 74 69 6e 67 20 69 |beyond g|etting i|
|00000ff0| 6e 76 6f 6b 65 64 20 66 | 72 6f 6d 20 74 68 65 20 |nvoked f|rom the |
|00001000| 65 78 74 65 72 6e 61 6c | 20 6d 65 6e 75 2c 20 64 |external| menu, d|
|00001010| 6f 69 6e 67 20 69 74 73 | 20 74 68 69 6e 67 2c 20 |oing its| thing, |
|00001020| 61 6e 64 20 74 68 65 6e | 20 72 65 74 75 72 6e 69 |and then| returni|
|00001030| 6e 67 2c 20 79 6f 75 20 | 77 69 6c 6c 20 77 61 6e |ng, you |will wan|
|00001040| 74 20 74 6f 20 73 65 74 | 20 74 68 69 73 20 74 6f |t to set| this to|
|00001050| 20 66 61 6c 73 65 2e 20 | 20 46 6f 72 20 6d 6f 73 | false. | For mos|
|00001060| 74 20 6f 74 68 65 72 20 | 65 78 74 65 72 6e 61 6c |t other |external|
|00001070| 73 20 68 6f 77 65 76 65 | 72 2c 20 74 68 69 73 20 |s howeve|r, this |
|00001080| 77 69 6c 6c 20 62 65 20 | 73 65 74 20 74 6f 20 74 |will be |set to t|
|00001090| 72 75 65 2e 20 20 46 6f | 72 20 69 6e 73 74 61 6e |rue.  Fo|r instan|
|000010a0| 63 65 2c 20 69 66 20 79 | 6f 75 20 77 61 6e 74 65 |ce, if y|ou wante|
|000010b0| 64 20 79 6f 75 72 20 65 | 78 74 65 72 6e 61 6c 20 |d your e|xternal |
|000010c0| 74 6f 20 62 65 20 69 6e | 76 6f 6b 65 64 20 62 79 |to be in|voked by|
|000010d0| 20 74 68 65 20 d2 56 d3 | 20 63 6f 6d 6d 61 6e 64 | the .V.| command|
|000010e0| 20 6f 6e 20 74 68 65 20 | 6d 61 69 6e 20 6d 65 6e | on the |main men|
|000010f0| 75 2c 20 79 6f 75 20 77 | 6f 75 6c 64 20 63 6f 6e |u, you w|ould con|
|00001100| 74 69 6e 75 61 6c 6c 79 | 20 63 68 65 63 6b 20 65 |tinually| check e|
|00001110| 76 65 72 79 20 74 69 6d | 65 20 79 6f 75 20 61 72 |very tim|e you ar|
|00001120| 65 20 63 61 6c 6c 65 64 | 20 69 6e 20 74 68 69 73 |e called| in this|
|00001130| 20 69 64 6c 65 20 6c 6f | 6f 70 20 74 6f 20 73 65 | idle lo|op to se|
|00001140| 65 20 69 66 20 74 68 65 | 20 75 73 65 72 20 68 61 |e if the| user ha|
|00001150| 73 20 74 79 70 65 64 20 | d2 56 d3 20 61 74 20 74 |s typed |.V. at t|
|00001160| 68 65 20 6d 61 69 6e 20 | 6d 65 6e 75 20 70 72 6f |he main |menu pro|
|00001170| 6d 70 74 2e 20 20 59 6f | 75 20 77 6f 75 6c 64 20 |mpt.  Yo|u would |
|00001180| 74 68 65 6e 20 74 61 6b | 65 20 63 6f 6e 74 72 6f |then tak|e contro|
|00001190| 6c 2e 20 20 41 20 73 69 | 64 65 20 6e 6f 74 65 20 |l.  A si|de note |
|000011a0| 68 65 72 65 20 77 6f 75 | 6c 64 20 62 65 20 74 68 |here wou|ld be th|
|000011b0| 61 74 20 79 6f 75 20 77 | 6f 75 6c 64 20 66 69 72 |at you w|ould fir|
|000011c0| 73 74 20 68 61 76 65 20 | 74 6f 20 61 64 64 20 d2 |st have |to add .|
|000011d0| 56 d3 20 74 6f 20 74 68 | 65 20 61 63 63 65 70 74 |V. to th|e accept|
|000011e0| 61 62 6c 65 20 6d 61 69 | 6e 20 6d 65 6e 75 20 63 |able mai|n menu c|
|000011f0| 6f 6d 6d 61 6e 64 73 20 | 6c 69 73 74 20 69 6e 20 |ommands |list in |
|00001200| 53 54 52 23 20 72 65 73 | 6f 75 72 63 65 20 49 44 |STR# res|ource ID|
|00001210| 3d 31 36 2e 0d ff 00 18 | 00 00 0c 01 00 0e 00 09 |=16.....|........|
|00001220| 0c 00 00 0e 01 09 0c 00 | 00 0e 02 09 0c 00 00 0e |........|........|
|00001230| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 fb 6d 69 |........|......mi|
|00001240| 6e 53 4c 66 6f 72 4d 65 | 6e 75 3a 20 54 68 69 73 |nSLforMe|nu: This|
|00001250| 20 6e 75 6d 62 65 72 20 | 72 65 70 72 65 73 65 6e | number |represen|
|00001260| 74 73 20 74 68 65 20 6d | 69 6e 69 6d 75 6d 20 73 |ts the m|inimum s|
|00001270| 65 63 75 72 69 74 79 20 | 6c 65 76 65 6c 20 72 65 |ecurity |level re|
|00001280| 71 75 69 72 65 64 20 66 | 6f 72 20 79 6f 75 72 20 |quired f|or your |
|00001290| 65 78 74 65 72 6e 61 6c | 20 74 6f 20 62 65 20 73 |external| to be s|
|000012a0| 65 65 6e 20 6f 6e 20 74 | 68 65 20 65 78 74 65 72 |een on t|he exter|
|000012b0| 6e 61 6c 73 20 6d 65 6e | 75 20 61 63 63 65 73 73 |nals men|u access|
|000012c0| 65 64 20 62 79 20 74 68 | 65 20 d2 2e d3 20 63 6f |ed by th|e ... co|
|000012d0| 6d 6d 61 6e 64 20 66 72 | 6f 6d 20 74 68 65 20 6d |mmand fr|om the m|
|000012e0| 61 69 6e 20 6d 65 6e 75 | 2e 20 20 53 65 74 74 69 |ain menu|.  Setti|
|000012f0| 6e 67 20 74 68 69 73 20 | 61 62 6f 76 65 20 32 35 |ng this |above 25|
|00001300| 35 20 77 69 6c 6c 20 6d | 61 6b 65 20 73 75 72 65 |5 will m|ake sure|
|00001310| 20 69 74 20 69 73 20 6e | 65 76 65 72 20 73 65 65 | it is n|ever see|
|00001320| 6e 20 6f 6e 20 74 68 65 | 20 65 78 74 65 72 6e 61 |n on the| externa|
|00001330| 6c 73 20 6d 65 6e 75 2e | 0d ff 00 0c 00 00 0c 01 |ls menu.|........|
|00001340| 00 0e 00 0d 0c 00 00 0e | 00 01 0d ff 00 06 00 00 |........|........|
|00001350| 0c 00 00 0e 01 2c 52 65 | 73 74 72 69 63 74 69 6f |.....,Re|strictio|
|00001360| 6e 3a 20 49 66 20 74 68 | 69 73 20 69 73 20 6e 6f |n: If th|is is no|
|00001370| 74 20 65 71 75 61 6c 20 | 74 6f 20 61 20 6e 75 6c |t equal |to a nul|
|00001380| 6c 20 63 68 61 72 61 63 | 74 65 72 2c 20 69 74 20 |l charac|ter, it |
|00001390| 6d 75 73 74 20 62 65 20 | 65 71 75 61 6c 20 74 6f |must be |equal to|
|000013a0| 20 61 20 63 61 70 69 74 | 61 6c 20 63 68 61 72 61 | a capit|al chara|
|000013b0| 63 74 65 72 20 66 72 6f | 6d 20 d2 41 d3 20 74 6f |cter fro|m .A. to|
|000013c0| 20 d2 5a d3 20 72 65 70 | 72 65 73 65 6e 74 69 6e | .Z. rep|resentin|
|000013d0| 67 20 74 68 65 20 72 65 | 73 74 72 69 63 74 69 6f |g the re|strictio|
|000013e0| 6e 20 61 20 75 73 65 72 | 20 69 73 20 72 65 71 75 |n a user| is requ|
|000013f0| 69 72 65 64 20 74 6f 20 | 68 61 76 65 20 69 6e 20 |ired to |have in |
|00001400| 6f 72 64 65 72 20 74 6f | 20 73 65 65 20 74 68 69 |order to| see thi|
|00001410| 73 20 65 78 74 65 72 6e | 61 6c 20 6f 6e 20 74 68 |s extern|al on th|
|00001420| 65 20 65 78 74 65 72 6e | 61 6c 73 20 6d 65 6e 75 |e extern|als menu|
|00001430| 2e 20 20 53 65 74 74 69 | 6e 67 20 74 68 69 73 20 |.  Setti|ng this |
|00001440| 74 6f 20 61 20 6e 75 6c | 6c 20 63 68 61 72 61 63 |to a nul|l charac|
|00001450| 74 65 72 20 77 69 6c 6c | 20 63 61 6e 63 65 6c 20 |ter will| cancel |
|00001460| 74 68 65 20 63 68 65 63 | 6b 69 6e 67 20 66 6f 72 |the chec|king for|
|00001470| 20 74 68 65 20 72 65 73 | 74 72 69 63 74 69 6f 6e | the res|triction|
|00001480| 2e 0d 00 12 00 00 0c 01 | 00 0e 00 0c 0c 00 00 0e |........|........|
|00001490| 01 0c 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|000014a0| 00 0e 01 68 49 74 20 69 | 73 20 72 65 63 63 6f 6d |...hIt i|s reccom|
|000014b0| 65 6e 64 65 64 20 74 68 | 61 74 20 79 6f 75 20 67 |ended th|at you g|
|000014c0| 69 76 65 20 75 73 65 72 | 73 20 61 20 73 79 73 6f |ive user|s a syso|
|000014d0| 70 20 65 78 74 65 72 6e | 61 6c 20 77 69 74 68 20 |p extern|al with |
|000014e0| 77 68 69 63 68 20 74 6f | 20 63 6f 6e 66 69 67 75 |which to| configu|
|000014f0| 72 65 20 74 68 65 73 65 | 20 63 6f 6d 6d 61 6e 64 |re these| command|
|00001500| 73 20 61 6e 64 20 61 6e | 79 20 6f 74 68 65 72 20 |s and an|y other |
|00001510| 6f 70 74 69 6f 6e 73 20 | 79 6f 75 20 63 61 6e 20 |options |you can |
|00001520| 70 72 6f 76 69 64 65 20 | 69 6e 20 79 6f 75 72 20 |provide |in your |
|00001530| 65 78 74 65 72 6e 61 6c | 2e 20 20 55 6e 6c 65 73 |external|.  Unles|
|00001540| 73 20 6f 66 20 63 6f 75 | 72 73 65 20 74 68 61 74 |s of cou|rse that|
|00001550| 20 69 73 20 6e 6f 74 20 | 61 70 70 72 6f 70 72 69 | is not |appropri|
|00001560| 61 74 65 20 66 6f 72 20 | 79 6f 75 72 20 65 78 74 |ate for |your ext|
|00001570| 65 72 6e 61 6c 2e 20 20 | 54 68 65 20 55 70 64 61 |ernal.  |The Upda|
|00001580| 74 65 20 50 68 6f 6e 65 | 20 65 78 74 65 72 6e 61 |te Phone| externa|
|00001590| 6c 20 68 61 73 20 6e 6f | 20 73 79 73 6f 70 20 65 |l has no| sysop e|
|000015a0| 78 74 65 72 6e 61 6c 20 | 20 61 6e 64 20 73 69 6d |xternal | and sim|
|000015b0| 70 6c 79 20 6c 65 61 76 | 65 73 20 61 6c 6c 20 74 |ply leav|es all t|
|000015c0| 68 65 20 66 69 65 6c 64 | 73 20 69 6e 20 74 68 65 |he field|s in the|
|000015d0| 20 48 52 4d 53 20 72 65 | 73 6f 75 72 63 65 20 61 | HRMS re|source a|
|000015e0| 74 20 30 20 62 65 63 61 | 75 73 65 20 69 74 20 69 |t 0 beca|use it i|
|000015f0| 73 20 6e 6f 74 20 6f 66 | 20 6d 75 63 68 20 69 6d |s not of| much im|
|00001600| 70 6f 72 74 61 6e 63 65 | 2e 20 20 0d 00 0c 00 00 |portance|.  .....|
|00001610| 0c 00 00 0e 01 00 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|00001620| 00 00 0c 00 00 0e 00 96 | 57 65 20 68 61 76 65 20 |........|We have |
|00001630| 6e 6f 77 20 63 6f 6d 70 | 6c 65 74 65 64 20 6f 75 |now comp|leted ou|
|00001640| 72 20 64 69 73 63 75 73 | 73 69 6f 6e 20 6f 66 20 |r discus|sion of |
|00001650| 74 68 65 20 67 65 6e 65 | 72 61 6c 20 66 69 6c 65 |the gene|ral file|
|00001660| 20 69 6e 74 65 72 66 61 | 63 65 20 66 6f 72 20 75 | interfa|ce for u|
|00001670| 73 65 72 20 65 78 74 65 | 72 6e 61 6c 73 2e 20 20 |ser exte|rnals.  |
|00001680| 54 68 65 20 6e 65 78 74 | 20 74 6f 70 69 63 20 69 |The next| topic i|
|00001690| 73 20 74 68 65 20 61 63 | 74 75 61 6c 20 63 61 6c |s the ac|tual cal|
|000016a0| 6c 69 6e 67 20 6d 65 74 | 68 6f 64 20 66 6f 72 20 |ling met|hod for |
|000016b0| 74 68 65 20 65 78 74 65 | 72 6e 61 6c 2e 0d 00 06 |the exte|rnal....|
|000016c0| 00 00 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|000016d0| 00 0e 00 01 0d ff 00 06 | 00 00 0c 00 00 0e 00 01 |........|........|
|000016e0| 0d ff 00 06 00 00 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|000016f0| 00 00 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|00001700| 00 0e 00 01 0d ff 00 06 | 00 00 0c 00 00 0e 00 00 |........|........|
|00001710| 01 da 01 00 00 00 00 00 | aa ac 00 00 00 14 00 63 |........|.......c|
|00001720| 88 b4 00 0a 00 8b 00 89 | 00 e9 01 f7 ff ff ff ff |........|........|
|00001730| 00 0f 43 61 6c 6c 69 6e | 67 20 4d 65 74 68 6f 64 |..Callin|g Method|
|00001740| 0d ff 00 06 00 00 0c 01 | 00 0e 00 01 0d ff 00 06 |........|........|
|00001750| 00 00 0c 01 00 0e 00 00 | 01 da 00 00 00 00 00 00 |........|........|
|00001760| aa ac 00 00 00 20 00 63 | 88 b4 00 0a 80 01 80 01 |..... .c|........|
|00001770| 7f ff 7f ff ff ff ff ff | 02 ea 41 6c 6c 20 6f 66 |........|..All of|
|00001780| 20 74 68 65 20 69 6e 74 | 65 72 66 61 63 65 73 20 | the int|erfaces |
|00001790| 69 6e 63 6c 75 64 65 64 | 20 61 72 65 20 69 6e 20 |included| are in |
|000017a0| 50 61 73 63 61 6c 2e 20 | 20 54 68 65 73 65 20 73 |Pascal. | These s|
|000017b0| 68 6f 75 6c 64 20 61 6c | 73 6f 20 77 6f 72 6b 20 |hould al|so work |
|000017c0| 66 69 6e 65 20 77 69 74 | 68 20 4d 50 57 20 50 61 |fine wit|h MPW Pa|
|000017d0| 73 63 61 6c 2c 20 61 6e | 64 20 63 6f 75 6c 64 20 |scal, an|d could |
|000017e0| 62 65 20 63 6f 6e 76 65 | 72 74 65 64 20 74 6f 20 |be conve|rted to |
|000017f0| 43 2e 20 20 53 6f 75 72 | 63 65 20 74 6f 20 74 68 |C.  Sour|ce to th|
|00001800| 65 20 55 70 64 61 74 65 | 20 50 68 6f 6e 65 20 65 |e Update| Phone e|
|00001810| 78 74 65 72 6e 61 6c 20 | 68 61 73 20 62 65 65 6e |xternal |has been|
|00001820| 20 69 6e 63 6c 75 64 65 | 64 20 61 6e 64 20 69 73 | include|d and is|
|00001830| 20 61 20 76 65 72 79 20 | 73 69 6d 70 6c 65 20 65 | a very |simple e|
|00001840| 78 74 65 72 6e 61 6c 20 | 74 68 61 74 20 73 68 6f |xternal |that sho|
|00001850| 75 6c 64 20 70 72 6f 76 | 69 64 65 20 6d 6f 73 74 |uld prov|ide most|
|00001860| 20 6f 66 20 74 68 65 20 | 69 6e 66 6f 72 6d 61 74 | of the |informat|
|00001870| 69 6f 6e 20 79 6f 75 20 | 6e 65 65 64 2e 20 20 57 |ion you |need.  W|
|00001880| 69 74 68 20 69 74 20 69 | 73 20 69 6e 63 6c 75 64 |ith it i|s includ|
|00001890| 65 64 20 74 68 65 20 6c | 61 74 65 73 74 20 76 65 |ed the l|atest ve|
|000018a0| 72 73 69 6f 6e 20 6f 66 | 20 74 68 65 20 48 65 72 |rsion of| the Her|
|000018b0| 6d 48 65 61 64 65 72 73 | 2e 70 20 66 69 6c 65 2e |mHeaders|.p file.|
|000018c0| 20 20 54 68 69 73 20 66 | 69 6c 65 20 6e 6f 77 20 |  This f|ile now |
|000018d0| 63 6f 6e 74 61 69 6e 73 | 20 74 6f 6e 73 20 6f 66 |contains| tons of|
|000018e0| 20 64 61 74 61 20 73 74 | 72 75 63 74 75 72 65 73 | data st|ructures|
|000018f0| 20 74 68 61 74 20 79 6f | 75 20 77 69 6c 6c 20 6e | that yo|u will n|
|00001900| 65 76 65 72 20 6e 65 65 | 64 2e 20 20 42 75 74 20 |ever nee|d.  But |
|00001910| 69 74 20 6a 75 73 74 20 | 72 65 70 72 65 73 65 6e |it just |represen|
|00001920| 74 73 20 74 68 65 20 70 | 6f 77 65 72 20 6e 6f 77 |ts the p|ower now|
|00001930| 20 61 76 61 69 6c 61 62 | 6c 65 20 77 69 74 68 20 | availab|le with |
|00001940| 75 73 65 72 20 65 78 74 | 65 72 6e 61 6c 73 2e 20 |user ext|ernals. |
|00001950| 20 54 68 65 20 69 6d 6d | 65 6e 73 65 20 73 74 72 | The imm|ense str|
|00001960| 75 63 74 75 72 65 20 69 | 6e 20 74 68 69 73 20 66 |ucture i|n this f|
|00001970| 69 6c 65 20 63 61 6c 6c | 65 64 20 74 68 65 20 48 |ile call|ed the H|
|00001980| 65 72 6d 55 73 65 72 47 | 6c 6f 62 73 52 65 63 20 |ermUserG|lobsRec |
|00001990| 69 73 20 74 68 65 20 73 | 61 6d 65 20 72 65 63 6f |is the s|ame reco|
|000019a0| 72 64 20 74 68 61 74 20 | 69 73 20 75 73 65 64 20 |rd that |is used |
|000019b0| 62 79 20 48 65 72 6d 65 | 73 20 74 6f 20 73 74 6f |by Herme|s to sto|
|000019c0| 72 65 20 65 76 65 72 79 | 20 73 69 6e 67 6c 65 20 |re every| single |
|000019d0| 76 61 72 69 61 62 6c 65 | 20 74 68 61 74 20 69 73 |variable| that is|
|000019e0| 20 73 61 76 65 64 20 66 | 6f 72 20 65 61 63 68 20 | saved f|or each |
|000019f0| 6e 6f 64 65 2e 20 20 54 | 68 65 73 65 20 61 72 65 |node.  T|hese are|
|00001a00| 20 70 61 73 73 65 64 20 | 74 6f 20 79 6f 75 20 74 | passed |to you t|
|00001a10| 68 65 20 65 78 74 65 72 | 6e 61 6c 20 69 6e 20 74 |he exter|nal in t|
|00001a20| 68 65 20 55 73 65 72 58 | 49 50 74 72 2e 20 20 54 |he UserX|IPtr.  T|
|00001a30| 68 65 20 70 72 6f 63 65 | 64 75 72 65 20 70 72 6f |he proce|dure pro|
|00001a40| 74 6f 74 79 70 65 20 66 | 6f 72 20 61 20 75 73 65 |totype f|or a use|
|00001a50| 72 20 65 78 74 65 72 6e | 61 6c 20 69 73 20 74 68 |r extern|al is th|
|00001a60| 69 73 3a 0d 00 2a 00 00 | 0c 00 00 0e 01 00 0c 00 |is:..*..|........|
|00001a70| 00 0e 02 00 0c 00 00 0e | 02 05 0c 01 00 0e 02 15 |........|........|
|00001a80| 0c 00 00 0e 02 a9 0c 01 | 00 0e 02 b2 0c 00 00 0e |........|........|
|00001a90| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 2a 70 72 |........|.....*pr|
|00001aa0| 6f 63 65 64 75 72 65 20 | 4d 41 49 4e 20 28 74 68 |ocedure |MAIN (th|
|00001ab0| 65 48 65 72 6d 53 74 75 | 66 66 3a 20 55 73 65 72 |eHermStu|ff: User|
|00001ac0| 58 49 50 74 72 29 3b 0d | 00 0c 00 00 09 01 00 03 |XIPtr);.|........|
|00001ad0| 00 0a 09 00 00 03 00 01 | 0d ff 00 06 00 00 09 00 |........|........|
|00001ae0| 00 03 01 43 59 6f 75 20 | 77 69 6c 6c 20 66 69 6e |...CYou |will fin|
|00001af0| 64 20 74 68 65 20 55 73 | 65 72 58 49 50 74 72 20 |d the Us|erXIPtr |
|00001b00| 61 73 20 74 68 65 20 6c | 61 73 74 20 73 74 72 75 |as the l|ast stru|
|00001b10| 63 74 75 72 65 20 69 6e | 20 74 68 65 20 48 65 72 |cture in| the Her|
|00001b20| 6d 48 65 61 64 65 72 73 | 2e 70 20 66 69 6c 65 2e |mHeaders|.p file.|
|00001b30| 20 20 49 74 20 64 69 72 | 65 63 74 6c 79 20 70 72 |  It dir|ectly pr|
|00001b40| 6f 63 65 65 64 73 20 74 | 68 65 20 48 65 72 6d 65 |oceeds t|he Herme|
|00001b50| 73 20 70 72 6f 63 65 64 | 75 72 65 73 20 69 6e 74 |s proced|ures int|
|00001b60| 65 72 66 61 63 65 73 2e | 20 20 45 61 63 68 20 6f |erfaces.|  Each o|
|00001b70| 66 20 74 68 65 20 70 72 | 6f 63 65 64 75 72 65 73 |f the pr|ocedures|
|00001b80| 20 6c 69 73 74 65 64 20 | 61 74 20 74 68 65 20 62 | listed |at the b|
|00001b90| 6f 74 74 6f 6d 20 6f 66 | 20 74 68 65 20 66 69 6c |ottom of| the fil|
|00001ba0| 65 20 61 72 65 20 61 76 | 61 69 6c 61 62 6c 65 20 |e are av|ailable |
|00001bb0| 74 6f 20 62 65 20 63 61 | 6c 6c 65 64 20 62 79 20 |to be ca|lled by |
|00001bc0| 79 6f 75 20 61 6e 64 20 | 61 72 65 20 64 65 66 69 |you and |are defi|
|00001bd0| 6e 65 64 20 69 6e 64 69 | 76 69 64 75 61 6c 6c 79 |ned indi|vidually|
|00001be0| 20 6c 61 74 65 72 20 69 | 6e 20 74 68 69 73 20 64 | later i|n this d|
|00001bf0| 6f 63 75 6d 65 6e 74 2e | 20 20 46 6f 72 20 6e 6f |ocument.|  For no|
|00001c00| 77 2c 20 6c 65 74 d5 73 | 20 74 61 6b 65 20 61 20 |w, let.s| take a |
|00001c10| 6c 6f 6f 6b 20 61 74 20 | 74 68 65 20 55 73 65 72 |look at |the User|
|00001c20| 58 49 50 74 72 3a 0d ff | 00 2a 00 00 0c 00 00 0e |XIPtr:..|.*......|
|00001c30| 00 12 0c 01 00 0e 00 1b | 0c 00 00 0e 00 39 0c 01 |........|.....9..|
|00001c40| 00 0e 00 46 0c 00 00 0e | 01 38 0c 01 00 0e 01 41 |...F....|.8.....A|
|00001c50| 0c 00 00 0e 00 1d 20 20 | 55 73 65 72 58 49 50 74 |......  |UserXIPt|
|00001c60| 72 20 3d 20 5e 55 73 65 | 72 58 49 6e 66 6f 52 65 |r = ^Use|rXInfoRe|
|00001c70| 63 3b 0d ff 00 0c 00 00 | 0c 00 00 0e 00 01 09 00 |c;......|........|
|00001c80| 00 03 00 18 20 20 55 73 | 65 72 58 49 6e 66 6f 52 |....  Us|erXInfoR|
|00001c90| 65 63 20 3d 20 72 65 63 | 6f 72 64 0d 00 12 00 00 |ec = rec|ord.....|
|00001ca0| 09 00 00 03 00 11 09 01 | 00 03 00 17 09 00 00 03 |........|........|
|00001cb0| 00 1b 20 20 20 20 70 72 | 69 76 61 74 65 73 3a 20 |..    pr|ivates: |
|00001cc0| 6d 79 50 72 69 76 73 48 | 61 6e 64 3b 0d ff 00 06 |myPrivsH|and;....|
|00001cd0| 00 00 09 00 00 03 00 14 | 20 20 20 20 65 78 74 49 |........|    extI|
|00001ce0| 44 3a 20 69 6e 74 65 67 | 65 72 3b 0d 00 06 00 00 |D: integ|er;.....|
|00001cf0| 09 00 00 03 00 19 20 20 | 20 20 74 6f 74 61 6c 4e |......  |  totalN|
|00001d00| 6f 64 65 73 3a 20 69 6e | 74 65 67 65 72 3b 0d ff |odes: in|teger;..|
|00001d10| 00 06 00 00 09 00 00 03 | 00 16 20 20 20 20 6d 65 |........|..    me|
|00001d20| 73 73 61 67 65 3a 20 69 | 6e 74 65 67 65 72 3b 0d |ssage: i|nteger;.|
|00001d30| 00 06 00 00 09 00 00 03 | 00 18 20 20 20 20 63 75 |........|..    cu|
|00001d40| 72 4e 6f 64 65 3a 20 50 | 74 72 54 6f 57 6f 72 64 |rNode: P|trToWord|
|00001d50| 3b 0d 00 06 00 00 09 00 | 00 03 00 1a 20 20 20 20 |;.......|....    |
|00001d60| 63 75 72 55 47 6c 6f 62 | 73 3a 20 50 74 72 54 6f |curUGlob|s: PtrTo|
|00001d70| 4c 6f 6e 67 3b 0d 00 06 | 00 00 09 00 00 03 00 18 |Long;...|........|
|00001d80| 20 20 20 20 52 65 73 53 | 68 61 72 65 64 3a 20 69 |    ResS|hared: i|
|00001d90| 6e 74 65 67 65 72 3b 0d | 00 06 00 00 09 00 00 03 |nteger;.|........|
|00001da0| 00 19 20 20 20 20 44 61 | 74 61 53 68 61 72 65 64 |..    Da|taShared|
|00001db0| 3a 20 69 6e 74 65 67 65 | 72 3b 0d ff 00 06 00 00 |: intege|r;......|
|00001dc0| 09 00 00 03 00 17 20 20 | 20 20 48 53 79 73 74 50 |......  |  HSystP|
|00001dd0| 74 72 3a 20 53 79 73 74 | 50 74 72 3b 0d ff 00 06 |tr: Syst|Ptr;....|
|00001de0| 00 00 09 00 00 03 00 19 | 20 20 20 20 48 4d 44 65 |........|    HMDe|
|00001df0| 73 63 50 74 72 3a 20 4d | 44 65 73 63 50 74 72 3b |scPtr: M|DescPtr;|
|00001e00| 0d ff 00 06 00 00 09 00 | 00 03 00 1d 20 20 20 20 |........|....    |
|00001e10| 48 44 69 72 44 61 74 61 | 50 74 72 3a 20 64 69 72 |HDirData|Ptr: dir|
|00001e20| 44 61 74 61 50 74 72 3b | 0d ff 00 06 00 00 09 00 |DataPtr;|........|
|00001e30| 00 03 00 1c 20 20 20 20 | 48 47 46 69 6c 65 50 74 |....    |HGFilePt|
|00001e40| 72 3a 20 47 46 69 6c 65 | 53 65 63 50 74 72 3b 0d |r: GFile|SecPtr;.|
|00001e50| 00 06 00 00 09 00 00 03 | 00 1a 20 20 20 20 66 69 |........|..    fi|
|00001e60| 6c 65 73 50 61 74 68 3a | 20 53 74 72 69 6e 67 50 |lesPath:| StringP|
|00001e70| 74 72 3b 0d 00 06 00 00 | 09 00 00 03 00 1a 20 20 |tr;.....|......  |
|00001e80| 20 20 48 65 72 6d 55 73 | 65 72 73 3a 20 55 4c 69 |  HermUs|ers: ULi|
|00001e90| 73 74 48 61 6e 64 3b 0d | 00 06 00 00 09 00 00 03 |stHand;.|........|
|00001ea0| 00 28 20 20 20 20 6e 3a | 20 61 72 72 61 79 5b 31 |.(    n:| array[1|
|00001eb0| 2e 2e 31 30 5d 20 6f 66 | 20 48 65 72 6d 55 73 65 |..10] of| HermUse|
|00001ec0| 72 47 6c 6f 62 50 74 72 | 3b 0d 00 1e 00 00 09 00 |rGlobPtr|;.......|
|00001ed0| 00 03 00 07 09 01 00 03 | 00 0c 09 00 00 03 00 14 |........|........|
|00001ee0| 09 01 00 03 00 16 09 00 | 00 03 00 23 20 20 20 20 |........|...#    |
|00001ef0| 70 72 6f 63 73 3a 20 61 | 72 72 61 79 5b 30 2e 2e |procs: a|rray[0..|
|00001f00| 30 5d 20 6f 66 20 70 72 | 6f 63 50 74 72 3b 0d ff |0] of pr|ocPtr;..|
|00001f10| 00 1e 00 00 09 00 00 03 | 00 0b 09 01 00 03 00 10 |........|........|
|00001f20| 09 00 00 03 00 17 09 01 | 00 03 00 19 09 00 00 03 |........|........|
|00001f30| 00 08 20 20 20 65 6e 64 | 3b 0d 00 06 00 00 09 00 |..   end|;.......|
|00001f40| 00 03 00 67 54 68 69 73 | 20 72 65 63 6f 72 64 20 |...gThis| record |
|00001f50| 69 73 20 70 61 73 73 65 | 64 20 74 6f 20 79 6f 75 |is passe|d to you|
|00001f60| 72 20 65 78 74 65 72 6e | 61 6c 20 65 61 63 68 20 |r extern|al each |
|00001f70| 74 69 6d 65 20 69 74 20 | 69 73 20 63 61 6c 6c 65 |time it |is calle|
|00001f80| 64 2e 20 20 41 6e 20 65 | 78 70 6c 61 6e 61 74 69 |d.  An e|xplanati|
|00001f90| 6f 6e 20 66 69 65 6c 64 | 20 62 79 20 66 69 65 6c |on field| by fiel|
|00001fa0| 64 20 66 6f 6c 6c 6f 77 | 73 3a 0d ff 00 06 00 00 |d follow|s:......|
|00001fb0| 0c 00 00 0e 00 01 0d ff | 00 06 00 00 0c 00 00 0e |........|........|
|00001fc0| 02 43 70 72 69 76 61 74 | 65 73 3a 20 20 54 68 69 |.Cprivat|es:  Thi|
|00001fd0| 73 20 66 69 65 6c 64 20 | 69 73 20 77 68 65 72 65 |s field |is where|
|00001fe0| 20 79 6f 75 20 73 74 6f | 72 65 20 79 6f 75 72 20 | you sto|re your |
|00001ff0| 6f 77 6e 20 76 61 72 69 | 61 62 6c 65 73 2e 20 20 |own vari|ables.  |
|00002000| 49 74 20 69 73 20 63 75 | 72 72 65 6e 74 6c 79 20 |It is cu|rrently |
|00002010| 64 65 63 6c 61 72 65 64 | 20 61 73 20 6d 79 50 72 |declared| as myPr|
|00002020| 69 76 73 48 61 6e 64 2e | 20 20 54 68 69 73 20 69 |ivsHand.|  This i|
|00002030| 73 20 61 72 62 69 74 72 | 61 72 79 2e 20 20 54 68 |s arbitr|ary.  Th|
|00002040| 65 20 6d 79 50 72 69 76 | 73 48 61 6e 64 20 73 74 |e myPriv|sHand st|
|00002050| 72 75 63 74 75 72 65 20 | 63 61 6e 20 62 65 20 66 |ructure |can be f|
|00002060| 6f 75 6e 64 20 69 6e 20 | 74 68 65 20 48 65 72 6d |ound in |the Herm|
|00002070| 48 65 61 64 65 72 73 2e | 70 20 66 69 6c 65 20 61 |Headers.|p file a|
|00002080| 6e 64 20 69 73 20 61 20 | 72 65 63 63 6f 6d 65 6e |nd is a |reccomen|
|00002090| 64 65 64 20 73 74 61 72 | 74 20 66 6f 72 20 77 68 |ded star|t for wh|
|000020a0| 61 74 20 76 61 72 69 61 | 62 6c 65 73 20 79 6f 75 |at varia|bles you|
|000020b0| 20 77 69 6c 6c 20 6e 65 | 65 64 2e 20 20 57 68 65 | will ne|ed.  Whe|
|000020c0| 6e 20 79 6f 75 72 20 65 | 78 74 65 72 6e 61 6c 20 |n your e|xternal |
|000020d0| 69 73 20 66 69 72 73 74 | 20 63 61 6c 6c 65 64 2c |is first| called,|
|000020e0| 20 74 68 69 73 20 66 69 | 65 6c 64 20 77 69 6c 6c | this fi|eld will|
|000020f0| 20 62 65 20 73 65 74 20 | 74 6f 20 30 2e 20 20 41 | be set |to 0.  A|
|00002100| 73 20 73 68 6f 77 6e 20 | 69 6e 20 74 68 65 20 55 |s shown |in the U|
|00002110| 70 64 61 74 65 20 50 68 | 6f 6e 65 20 65 78 74 65 |pdate Ph|one exte|
|00002120| 72 6e 61 6c 2c 20 79 6f | 75 20 73 68 6f 75 6c 64 |rnal, yo|u should|
|00002130| 20 74 68 65 6e 20 61 6c | 6c 6f 63 61 74 65 20 74 | then al|locate t|
|00002140| 68 65 20 62 6c 6f 63 6b | 20 66 6f 72 20 79 6f 75 |he block| for you|
|00002150| 72 20 76 61 72 69 61 62 | 6c 65 73 20 61 73 20 61 |r variab|les as a|
|00002160| 20 68 61 6e 64 6c 65 20 | 61 6e 64 20 75 73 65 20 | handle |and use |
|00002170| 74 68 69 73 20 66 69 65 | 6c 64 20 74 6f 20 73 74 |this fie|ld to st|
|00002180| 6f 72 65 20 74 68 61 74 | 20 68 61 6e 64 6c 65 2e |ore that| handle.|
|00002190| 20 20 49 74 20 77 69 6c | 6c 20 62 65 20 70 72 65 |  It wil|l be pre|
|000021a0| 73 65 72 76 65 64 20 61 | 63 72 6f 73 73 20 63 61 |served a|cross ca|
|000021b0| 6c 6c 73 20 74 6f 20 79 | 6f 75 2e 20 20 49 74 20 |lls to y|ou.  It |
|000021c0| 69 73 20 75 73 65 64 20 | 6d 75 63 68 20 6c 69 6b |is used |much lik|
|000021d0| 65 20 74 68 65 20 72 65 | 66 43 6f 6e 20 66 69 65 |e the re|fCon fie|
|000021e0| 6c 64 20 69 6e 20 6d 75 | 63 68 20 6f 66 20 74 68 |ld in mu|ch of th|
|000021f0| 65 20 4d 61 63 69 6e 74 | 6f 73 68 20 74 6f 6f 6c |e Macint|osh tool|
|00002200| 62 6f 78 2e 0d ff 00 18 | 00 00 0c 01 00 0e 00 0a |box.....|........|
|00002210| 0c 00 00 0e 01 0a 0c 00 | 00 0e 02 0a 0c 00 00 0e |........|........|
|00002220| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 d4 65 78 |........|......ex|
|00002230| 74 49 44 3a 20 54 68 69 | 73 20 66 69 65 6c 64 20 |tID: Thi|s field |
|00002240| 63 6f 6e 74 61 69 6e 73 | 20 74 68 65 20 6e 75 6d |contains| the num|
|00002250| 62 65 72 20 6f 66 20 79 | 6f 75 72 20 65 78 74 65 |ber of y|our exte|
|00002260| 72 6e 61 6c 20 61 63 63 | 6f 72 64 69 6e 67 20 74 |rnal acc|ording t|
|00002270| 6f 20 48 65 72 6d 65 73 | d5 20 69 6e 74 65 72 6e |o Hermes|. intern|
|00002280| 61 6c 20 6c 69 73 74 20 | 6f 66 20 65 78 74 65 72 |al list |of exter|
|00002290| 6e 61 6c 73 2e 20 20 49 | 74 20 69 73 20 75 73 65 |nals.  I|t is use|
|000022a0| 66 75 6c 20 66 6f 72 20 | 63 61 75 73 69 6e 67 20 |ful for |causing |
|000022b0| 61 20 73 77 69 74 63 68 | 20 6f 66 20 63 6f 6e 74 |a switch| of cont|
|000022c0| 72 6f 6c 20 74 6f 20 79 | 6f 75 72 20 65 78 74 65 |rol to y|our exte|
|000022d0| 72 6e 61 6c 20 61 73 20 | 65 78 70 6c 61 69 6e 65 |rnal as |explaine|
|000022e0| 64 20 6c 61 74 65 72 20 | 75 6e 64 65 72 20 74 68 |d later |under th|
|000022f0| 65 20 6d 65 73 73 61 67 | 65 20 66 69 65 6c 64 2e |e messag|e field.|
|00002300| 20 0d 00 0c 00 00 0c 01 | 00 0e 00 07 0c 00 00 0e | .......|........|
|00002310| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 a9 74 6f |........|......to|
|00002320| 74 61 6c 4e 6f 64 65 73 | 3a 20 54 68 69 73 20 69 |talNodes|: This i|
|00002330| 73 20 73 69 6d 70 6c 79 | 20 61 6e 20 69 6e 74 65 |s simply| an inte|
|00002340| 67 65 72 20 77 68 69 63 | 68 20 69 6e 64 69 63 61 |ger whic|h indica|
|00002350| 74 65 73 20 68 6f 77 20 | 6d 61 6e 79 20 6e 6f 64 |tes how |many nod|
|00002360| 65 73 20 61 72 65 20 61 | 6c 6c 6f 63 61 74 65 64 |es are a|llocated|
|00002370| 20 61 6e 64 20 61 63 74 | 69 76 65 20 63 75 72 72 | and act|ive curr|
|00002380| 65 6e 74 6c 79 2e 20 20 | 59 6f 75 20 63 61 6e 6e |ently.  |You cann|
|00002390| 6f 74 20 63 68 61 6e 67 | 65 20 74 68 69 73 2c 20 |ot chang|e this, |
|000023a0| 69 74 20 73 65 72 76 65 | 73 20 6f 6e 6c 79 20 74 |it serve|s only t|
|000023b0| 6f 20 74 65 6c 6c 20 79 | 6f 75 20 74 68 65 20 6e |o tell y|ou the n|
|000023c0| 75 6d 62 65 72 2e 0d ff | 00 0c 00 00 0c 01 00 0e |umber...|........|
|000023d0| 00 0c 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|000023e0| 00 0e 00 3d 6d 65 73 73 | 61 67 65 3a 20 54 68 69 |...=mess|age: Thi|
|000023f0| 73 20 66 69 65 6c 64 20 | 63 61 6e 20 63 6f 6e 74 |s field |can cont|
|00002400| 61 69 6e 20 6f 6e 65 20 | 6f 66 20 74 68 65 20 66 |ain one |of the f|
|00002410| 6f 6c 6c 6f 77 69 6e 67 | 20 76 61 6c 75 65 73 3a |ollowing| values:|
|00002420| 0d ff 00 0c 00 00 0c 01 | 00 0e 00 09 0c 00 00 0e |........|........|
|00002430| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 3c 20 20 |........|.....<  |
|00002440| 41 43 54 49 56 45 45 58 | 54 20 3d 20 31 3b 7b 76 |ACTIVEEX|T = 1;{v|
|00002450| 61 6c 75 65 73 20 66 6f | 72 20 6d 65 73 73 61 67 |alues fo|r messag|
|00002460| 65 20 66 69 65 6c 64 20 | 74 6f 20 75 73 65 72 20 |e field |to user |
|00002470| 65 78 74 65 72 6e 61 6c | 7d 0d 00 06 00 00 09 00 |external|}.......|
|00002480| 00 03 00 0c 20 20 49 44 | 4c 45 20 3d 20 32 3b 0d |....  ID|LE = 2;.|
|00002490| 00 06 00 00 09 00 00 03 | 00 11 20 20 43 4c 4f 53 |........|..  CLOS|
|000024a0| 45 4e 4f 44 45 20 3d 20 | 33 3b 0d ff 00 06 00 00 |ENODE = |3;......|
|000024b0| 09 00 00 03 00 15 20 20 | 43 4c 4f 53 45 45 58 54 |......  |CLOSEEXT|
|000024c0| 45 52 4e 41 4c 20 3d 20 | 34 3b 0d ff 00 06 00 00 |ERNAL = |4;......|
|000024d0| 09 00 00 03 00 01 0d ff | 00 06 00 00 09 00 00 03 |........|........|
|000024e0| 05 79 54 68 65 20 61 63 | 74 69 76 65 45 78 74 20 |.yThe ac|tiveExt |
|000024f0| 76 61 6c 75 65 20 6d 65 | 61 6e 73 20 79 6f 75 72 |value me|ans your|
|00002500| 20 65 78 74 65 72 6e 61 | 6c 20 69 73 20 63 75 72 | externa|l is cur|
|00002510| 72 65 6e 74 6c 79 20 62 | 65 69 6e 67 20 63 61 6c |rently b|eing cal|
|00002520| 6c 65 64 20 62 65 63 61 | 75 73 65 20 74 68 72 6f |led beca|use thro|
|00002530| 75 67 68 20 73 6f 6d 65 | 20 63 6f 6e 64 69 74 69 |ugh some| conditi|
|00002540| 6f 6e 20 74 68 65 20 42 | 42 53 20 74 68 69 6e 6b |on the B|BS think|
|00002550| 73 20 79 6f 75 20 68 61 | 76 65 20 62 65 65 6e 20 |s you ha|ve been |
|00002560| 73 65 6c 65 63 74 65 64 | 20 66 72 6f 6d 20 74 68 |selected| from th|
|00002570| 65 20 65 78 74 65 72 6e | 61 6c 73 20 6d 65 6e 75 |e extern|als menu|
|00002580| 2e 20 20 54 68 69 73 20 | 63 61 6e 20 62 65 20 63 |.  This |can be c|
|00002590| 61 75 73 65 64 20 69 6e | 20 74 77 6f 20 77 61 79 |aused in| two way|
|000025a0| 73 2e 20 20 54 68 65 20 | 66 69 72 73 74 20 69 73 |s.  The |first is|
|000025b0| 20 62 79 20 61 20 75 73 | 65 72 20 61 63 74 75 61 | by a us|er actua|
|000025c0| 6c 6c 79 20 73 65 6c 65 | 63 74 69 6e 67 20 79 6f |lly sele|cting yo|
|000025d0| 75 20 66 72 6f 6d 20 74 | 68 65 20 65 78 74 65 72 |u from t|he exter|
|000025e0| 6e 61 6c 73 20 6d 65 6e | 75 2e 20 20 54 68 65 20 |nals men|u.  The |
|000025f0| 73 65 63 6f 6e 64 20 69 | 73 20 69 66 20 79 6f 75 |second i|s if you|
|00002600| 20 73 65 74 20 74 68 65 | 20 42 6f 61 72 64 53 65 | set the| BoardSe|
|00002610| 63 74 69 6f 6e 20 76 61 | 72 69 61 62 6c 65 20 66 |ction va|riable f|
|00002620| 6f 72 20 61 20 70 61 72 | 74 69 63 75 6c 61 72 20 |or a par|ticular |
|00002630| 6e 6f 64 65 20 74 6f 20 | 45 58 54 45 52 4e 41 4c |node to |EXTERNAL|
|00002640| 20 61 6e 64 20 73 65 74 | 20 74 68 65 20 61 63 74 | and set| the act|
|00002650| 69 76 65 55 73 65 72 45 | 78 74 65 72 6e 61 6c 20 |iveUserE|xternal |
|00002660| 66 69 65 6c 64 20 74 6f | 20 79 6f 75 72 20 65 78 |field to| your ex|
|00002670| 74 65 72 6e 61 6c 20 6e | 75 6d 62 65 72 20 63 6f |ternal n|umber co|
|00002680| 6e 74 61 69 6e 65 64 20 | 69 6e 20 74 68 65 20 66 |ntained |in the f|
|00002690| 69 65 6c 64 20 65 78 74 | 49 44 2e 20 20 49 66 20 |ield ext|ID.  If |
|000026a0| 79 6f 75 20 73 65 74 20 | 74 68 65 73 65 20 74 77 |you set |these tw|
|000026b0| 6f 20 76 61 72 69 61 62 | 6c 65 73 20 69 6e 20 79 |o variab|les in y|
|000026c0| 6f 75 72 20 69 64 6c 65 | 20 72 6f 75 74 69 6e 65 |our idle| routine|
|000026d0| 2c 20 79 6f 75 20 77 69 | 6c 6c 20 74 68 65 6e 20 |, you wi|ll then |
|000026e0| 62 65 20 63 61 6c 6c 65 | 64 20 77 69 74 68 20 74 |be calle|d with t|
|000026f0| 68 65 20 61 63 74 69 76 | 65 45 78 74 20 6d 65 73 |he activ|eExt mes|
|00002700| 73 61 67 65 2e 20 20 54 | 68 65 20 49 64 6c 65 20 |sage.  T|he Idle |
|00002710| 6d 65 73 73 61 67 65 20 | 69 73 20 73 65 6e 74 20 |message |is sent |
|00002720| 6f 6e 6c 79 20 74 6f 20 | 65 78 74 65 72 6e 61 6c |only to |external|
|00002730| 73 20 77 68 69 63 68 20 | 68 61 76 65 20 74 68 65 |s which |have the|
|00002740| 20 61 6c 6c 54 69 6d 65 | 20 76 61 72 69 61 62 6c | allTime| variabl|
|00002750| 65 20 73 65 74 20 74 6f | 20 74 72 75 65 20 69 6e |e set to| true in|
|00002760| 20 74 68 65 69 72 20 48 | 52 4d 53 20 31 30 30 20 | their H|RMS 100 |
|00002770| 72 65 73 6f 75 72 63 65 | 2e 20 20 49 66 20 74 68 |resource|.  If th|
|00002780| 69 73 20 76 61 72 69 61 | 62 6c 65 20 69 73 20 74 |is varia|ble is t|
|00002790| 72 75 65 2c 20 79 6f 75 | 20 77 69 6c 6c 20 62 65 |rue, you| will be|
|000027a0| 20 63 61 6c 6c 65 64 20 | 77 69 74 68 20 74 68 65 | called |with the|
|000027b0| 20 49 64 6c 65 20 6d 65 | 73 73 61 67 65 20 6f 6e | Idle me|ssage on|
|000027c0| 20 65 76 65 72 79 20 65 | 76 65 6e 74 20 6c 6f 6f | every e|vent loo|
|000027d0| 70 20 6f 66 20 48 65 72 | 6d 65 73 2e 20 20 44 69 |p of Her|mes.  Di|
|000027e0| 72 65 63 74 6c 79 20 61 | 66 74 65 72 20 79 6f 75 |rectly a|fter you|
|000027f0| 20 61 72 65 20 63 61 6c | 6c 65 64 20 77 69 74 68 | are cal|led with|
|00002800| 20 74 68 69 73 20 6d 65 | 73 73 61 67 65 2c 20 48 | this me|ssage, H|
|00002810| 65 72 6d 65 73 20 63 61 | 6c 6c 73 20 69 74 73 20 |ermes ca|lls its |
|00002820| 6f 77 6e 20 49 64 6c 65 | 55 73 65 72 20 72 6f 75 |own Idle|User rou|
|00002830| 74 69 6e 65 20 77 68 69 | 63 68 20 68 61 6e 64 6c |tine whi|ch handl|
|00002840| 65 73 20 63 61 72 72 69 | 65 72 20 64 65 74 65 63 |es carri|er detec|
|00002850| 74 2c 20 74 69 6d 65 6f | 75 74 73 2c 20 61 6e 64 |t, timeo|uts, and|
|00002860| 20 73 65 72 69 61 6c 20 | 70 6f 72 74 20 74 65 6e | serial |port ten|
|00002870| 64 69 6e 67 2e 20 20 54 | 68 65 20 63 6c 6f 73 65 |ding.  T|he close|
|00002880| 4e 6f 64 65 20 6d 65 73 | 73 61 67 65 20 69 73 20 |Node mes|sage is |
|00002890| 73 65 6e 74 20 74 6f 20 | 61 6e 20 65 78 74 65 72 |sent to |an exter|
|000028a0| 6e 61 6c 20 77 68 65 6e | 20 74 68 65 20 75 73 65 |nal when| the use|
|000028b0| 72 20 6f 6e 20 74 68 65 | 20 6e 6f 64 65 20 63 75 |r on the| node cu|
|000028c0| 72 4e 6f 64 65 20 68 61 | 73 20 6c 6f 67 67 65 64 |rNode ha|s logged|
|000028d0| 20 6f 66 66 20 6f 72 20 | 73 6f 6d 65 20 6f 74 68 | off or |some oth|
|000028e0| 65 72 20 63 6f 6e 64 69 | 74 69 6f 6e 20 68 61 73 |er condi|tion has|
|000028f0| 20 63 61 75 73 65 64 20 | 74 68 69 73 20 6e 6f 64 | caused |this nod|
|00002900| 65 20 74 6f 20 73 74 6f | 70 20 79 6f 75 72 20 65 |e to sto|p your e|
|00002910| 78 74 65 72 6e 61 6c 20 | 73 75 63 68 20 74 68 61 |xternal |such tha|
|00002920| 74 20 69 74 20 63 61 6e | 6e 6f 74 20 63 6f 6e 74 |t it can|not cont|
|00002930| 69 6e 75 65 20 74 6f 20 | 65 78 65 63 75 74 65 20 |inue to |execute |
|00002940| 69 74 20 66 6f 72 20 74 | 68 69 73 20 6e 6f 64 65 |it for t|his node|
|00002950| 2e 20 20 54 68 69 73 20 | 64 6f 65 73 20 6e 6f 74 |.  This |does not|
|00002960| 20 6d 65 61 6e 20 79 6f | 75 20 73 68 6f 75 6c 64 | mean yo|u should|
|00002970| 20 64 69 73 70 6f 73 65 | 20 6f 66 20 65 76 65 72 | dispose| of ever|
|00002980| 79 74 68 69 6e 67 2e 20 | 20 4a 75 73 74 20 73 74 |ything. | Just st|
|00002990| 6f 70 20 61 6e 79 20 70 | 6c 61 6e 6e 65 64 20 61 |op any p|lanned a|
|000029a0| 63 74 69 6f 6e 73 20 66 | 6f 72 20 74 68 61 74 20 |ctions f|or that |
|000029b0| 70 61 72 74 69 63 75 6c | 61 72 20 6e 6f 64 65 2e |particul|ar node.|
|000029c0| 20 20 54 68 65 20 63 6c | 6f 73 65 45 78 74 65 72 |  The cl|oseExter|
|000029d0| 6e 61 6c 20 6d 65 73 73 | 61 67 65 20 69 73 20 73 |nal mess|age is s|
|000029e0| 65 6e 74 20 74 6f 20 79 | 6f 75 72 20 65 78 74 65 |ent to y|our exte|
|000029f0| 72 6e 61 6c 20 77 68 65 | 6e 20 48 65 72 6d 65 73 |rnal whe|n Hermes|
|00002a00| 20 71 75 69 74 73 2e 20 | 20 59 6f 75 20 73 68 6f | quits. | You sho|
|00002a10| 75 6c 64 20 63 6c 65 61 | 6e 20 75 70 20 69 6d 6d |uld clea|n up imm|
|00002a20| 65 64 69 61 74 65 6c 79 | 20 61 6e 64 20 64 69 73 |ediately| and dis|
|00002a30| 70 6f 73 65 20 6f 66 20 | 61 6e 79 20 73 74 72 75 |pose of |any stru|
|00002a40| 63 74 75 72 65 73 20 79 | 6f 75 20 68 61 76 65 20 |ctures y|ou have |
|00002a50| 61 6c 6c 6f 63 61 74 65 | 64 2e 0d ff 00 84 00 00 |allocate|d.......|
|00002a60| 0c 00 00 0e 00 04 0c 01 | 00 0e 00 0d 0c 00 00 0e |........|........|
|00002a70| 01 0d 0c 00 00 0e 01 27 | 0c 01 00 0e 01 33 0c 00 |.......'|.....3..|
|00002a80| 00 0e 01 56 0c 01 00 0e | 01 5e 0c 00 00 0e 01 6b |...V....|.^.....k|
|00002a90| 0c 01 00 0e 01 7d 0c 00 | 00 0e 01 b3 0c 01 00 0e |.....}..|........|
|00002aa0| 01 b8 0c 00 00 0e 02 29 | 0c 01 00 0e 02 2d 0c 00 |.......)|.....-..|
|00002ab0| 00 0e 02 5f 0c 01 00 0e | 02 66 0c 00 00 0e 03 66 |..._....|.f.....f|
|00002ac0| 0c 00 00 0e 03 99 0c 01 | 00 0e 03 a2 0c 00 00 0e |........|........|
|00002ad0| 04 a2 0c 00 00 0e 04 e4 | 0c 01 00 0e 04 f1 0c 00 |........|........|
|00002ae0| 00 0e 00 01 0d ff 00 06 | 00 00 0c 00 00 0e 01 ba |........|........|
|00002af0| 63 75 72 4e 6f 64 65 3a | 20 54 68 69 73 20 66 69 |curNode:| This fi|
|00002b00| 65 6c 64 20 69 73 20 61 | 20 70 6f 69 6e 74 65 72 |eld is a| pointer|
|00002b10| 20 74 6f 20 61 6e 20 69 | 6e 74 65 67 65 72 20 77 | to an i|nteger w|
|00002b20| 68 69 63 68 20 63 6f 6e | 74 61 69 6e 73 20 74 68 |hich con|tains th|
|00002b30| 65 20 61 63 74 69 76 65 | 20 6e 6f 64 65 20 6e 75 |e active| node nu|
|00002b40| 6d 62 65 72 20 74 68 61 | 74 20 79 6f 75 20 61 72 |mber tha|t you ar|
|00002b50| 65 20 62 65 69 6e 67 20 | 63 61 6c 6c 65 64 20 74 |e being |called t|
|00002b60| 6f 20 68 61 6e 64 6c 65 | 2e 20 20 54 68 69 73 20 |o handle|.  This |
|00002b70| 66 69 65 6c 64 20 69 73 | 20 69 6e 76 61 6c 69 64 |field is| invalid|
|00002b80| 20 77 68 65 6e 20 79 6f | 75 20 61 72 65 20 63 61 | when yo|u are ca|
|00002b90| 6c 6c 65 64 20 77 69 74 | 68 20 74 68 65 20 49 64 |lled wit|h the Id|
|00002ba0| 6c 65 20 6d 65 73 73 61 | 67 65 2e 20 20 42 75 74 |le messa|ge.  But|
|00002bb0| 20 69 74 20 69 73 20 6e | 65 63 65 73 73 61 72 79 | it is n|ecessary|
|00002bc0| 20 77 68 65 6e 20 63 61 | 6c 6c 65 64 20 77 69 74 | when ca|lled wit|
|00002bd0| 68 20 74 68 65 20 61 63 | 74 69 76 65 45 78 74 20 |h the ac|tiveExt |
|00002be0| 6d 65 73 73 61 67 65 2e | 20 20 54 68 65 20 72 65 |message.|  The re|
|00002bf0| 61 73 6f 6e 20 69 74 20 | 69 73 20 61 20 70 6f 69 |ason it |is a poi|
|00002c00| 6e 74 65 72 20 69 73 20 | 62 65 63 61 75 73 65 20 |nter is |because |
|00002c10| 74 68 65 20 76 61 72 69 | 61 62 6c 65 20 69 74 20 |the vari|able it |
|00002c20| 70 6f 69 6e 74 73 20 74 | 6f 20 69 73 20 74 68 65 |points t|o is the|
|00002c30| 20 73 61 6d 65 20 76 61 | 72 69 61 62 6c 65 20 48 | same va|riable H|
|00002c40| 65 72 6d 65 73 20 75 73 | 65 73 20 74 6f 20 64 65 |ermes us|es to de|
|00002c50| 74 65 72 6d 69 6e 65 20 | 74 68 65 20 61 63 74 69 |termine |the acti|
|00002c60| 76 65 20 6e 6f 64 65 2e | 20 20 59 6f 75 20 73 68 |ve node.|  You sh|
|00002c70| 6f 75 6c 64 20 62 65 77 | 61 72 65 20 6f 66 20 73 |ould bew|are of s|
|00002c80| 77 69 74 63 68 69 6e 67 | 20 69 74 2c 20 62 75 74 |witching| it, but|
|00002c90| 20 74 68 61 74 20 70 6f | 77 65 72 20 69 73 20 61 | that po|wer is a|
|00002ca0| 76 61 69 6c 61 62 6c 65 | 2e 0d 00 12 00 00 0c 01 |vailable|........|
|00002cb0| 00 0e 00 09 0c 00 00 0e | 01 09 0c 00 00 0e 00 01 |........|........|
|00002cc0| 0d ff 00 06 00 00 0c 00 | 00 0e 02 dc 63 75 72 55 |........|....curU|
|00002cd0| 47 6c 6f 62 73 3a 20 54 | 68 69 73 20 66 69 65 6c |Globs: T|his fiel|
|00002ce0| 64 20 69 73 20 61 20 70 | 6f 69 6e 74 65 72 20 74 |d is a p|ointer t|
|00002cf0| 6f 20 61 20 70 6f 69 6e | 74 65 72 2e 20 20 54 68 |o a poin|ter.  Th|
|00002d00| 65 20 72 65 61 73 6f 6e | 20 66 6f 72 20 74 68 69 |e reason| for thi|
|00002d10| 73 20 69 73 20 73 69 6d | 69 6c 61 72 20 74 6f 20 |s is sim|ilar to |
|00002d20| 74 68 65 20 72 65 61 73 | 6f 6e 20 63 75 72 4e 6f |the reas|on curNo|
|00002d30| 64 65 20 69 73 20 61 20 | 70 6f 69 6e 74 65 72 2e |de is a |pointer.|
|00002d40| 20 20 49 74 20 70 6f 69 | 6e 74 73 20 74 6f 20 61 |  It poi|nts to a|
|00002d50| 6e 20 61 63 74 75 61 6c | 20 67 6c 6f 62 61 6c 20 |n actual| global |
|00002d60| 76 61 72 69 61 62 6c 65 | 20 69 6e 20 48 65 72 6d |variable| in Herm|
|00002d70| 65 73 20 74 68 61 74 20 | 69 73 20 75 73 65 64 20 |es that |is used |
|00002d80| 62 79 20 61 6c 6d 6f 73 | 74 20 65 76 65 72 79 20 |by almos|t every |
|00002d90| 73 69 6e 67 6c 65 20 72 | 6f 75 74 69 6e 65 2e 20 |single r|outine. |
|00002da0| 20 54 68 65 20 76 61 6c | 75 65 20 70 6f 69 6e 74 | The val|ue point|
|00002db0| 65 64 20 74 6f 20 77 69 | 6c 6c 20 62 65 20 65 78 |ed to wi|ll be ex|
|00002dc0| 61 63 74 6c 79 20 74 68 | 65 20 73 61 6d 65 20 61 |actly th|e same a|
|00002dd0| 73 20 74 68 65 20 76 61 | 6c 75 65 20 6f 66 20 6e |s the va|lue of n|
|00002de0| 5b 63 75 72 4e 6f 64 65 | 5e 5d 2e 20 20 54 68 65 |[curNode|^].  The|
|00002df0| 20 6f 6e 6c 79 20 72 65 | 61 73 6f 6e 20 79 6f 75 | only re|ason you|
|00002e00| 20 77 6f 75 6c 64 20 65 | 76 65 72 20 63 68 61 6e | would e|ver chan|
|00002e10| 67 65 20 74 68 69 73 20 | 76 61 72 69 61 62 6c 65 |ge this |variable|
|00002e20| 20 77 6f 75 6c 64 20 62 | 65 20 74 6f 20 73 77 69 | would b|e to swi|
|00002e30| 74 63 68 20 62 65 74 77 | 65 65 6e 20 6e 6f 64 65 |tch betw|een node|
|00002e40| 73 2e 20 20 46 6f 72 20 | 69 6e 73 74 61 6e 63 65 |s.  For |instance|
|00002e50| 2c 20 69 66 20 79 6f 75 | 20 68 61 64 20 61 20 72 |, if you| had a r|
|00002e60| 6f 75 74 69 6e 65 20 74 | 68 61 74 20 72 61 6e 20 |outine t|hat ran |
|00002e70| 65 76 65 72 79 20 69 64 | 6c 65 20 6d 65 73 73 61 |every id|le messa|
|00002e80| 67 65 20 74 68 61 74 20 | 77 6f 75 6c 64 20 6f 75 |ge that |would ou|
|00002e90| 74 70 75 74 20 61 20 6c | 69 6e 65 20 6f 6e 20 61 |tput a l|ine on a|
|00002ea0| 6e 79 20 6e 6f 64 65 20 | 74 68 61 74 20 77 61 73 |ny node |that was|
|00002eb0| 20 61 74 20 61 20 63 65 | 72 74 61 69 6e 20 42 6f | at a ce|rtain Bo|
|00002ec0| 61 72 64 53 65 63 74 69 | 6f 6e 2c 20 79 6f 75 20 |ardSecti|on, you |
|00002ed0| 77 6f 75 6c 64 20 68 61 | 76 65 20 74 6f 20 74 65 |would ha|ve to te|
|00002ee0| 6c 6c 20 48 65 72 6d 65 | 73 20 65 78 61 63 74 6c |ll Herme|s exactl|
|00002ef0| 79 20 77 68 69 63 68 20 | 6e 64 6f 65 20 79 6f 75 |y which |ndoe you|
|00002f00| 20 61 72 65 20 74 61 6c | 6b 69 6e 67 20 61 62 6f | are tal|king abo|
|00002f10| 75 74 20 77 68 65 6e 20 | 79 6f 75 20 75 73 65 20 |ut when |you use |
|00002f20| 4f 75 74 4c 69 6e 65 20 | 73 69 6e 63 65 20 63 75 |OutLine |since cu|
|00002f30| 72 4e 6f 64 65 20 69 73 | 20 6d 65 61 6e 69 6e 67 |rNode is| meaning|
|00002f40| 6c 65 73 73 20 64 75 72 | 69 6e 67 20 74 68 65 20 |less dur|ing the |
|00002f50| 49 64 6c 65 20 6d 65 73 | 73 61 67 65 2e 20 20 54 |Idle mes|sage.  T|
|00002f60| 68 69 73 20 69 73 20 77 | 68 61 74 20 79 6f 75 20 |his is w|hat you |
|00002f70| 77 6f 75 6c 64 20 64 6f | 20 69 66 20 79 6f 75 20 |would do| if you |
|00002f80| 77 61 6e 74 20 74 6f 20 | 73 65 74 20 74 68 65 20 |want to |set the |
|00002f90| 63 75 72 72 65 6e 74 20 | 6e 6f 64 65 20 74 6f 20 |current |node to |
|00002fa0| 6e 6f 64 65 20 34 3a 0d | 00 18 00 00 0c 01 00 0e |node 4:.|........|
|00002fb0| 00 0b 0c 00 00 0e 01 0b | 0c 00 00 0e 02 0b 0c 00 |........|........|
|00002fc0| 00 0e 00 0e 09 63 75 72 | 4e 6f 64 65 5e 3a 3d 34 |.....cur|Node^:=4|
|00002fd0| 3b 0d 00 06 00 00 09 00 | 00 03 00 13 09 63 75 72 |;.......|.....cur|
|00002fe0| 55 47 6c 6f 62 73 5e 3a | 3d 6e 5b 34 5d 3b 0d ff |UGlobs^:|=n[4];..|
|00002ff0| 00 06 00 00 09 00 00 03 | 00 79 59 6f 75 20 6d 75 |........|.yYou mu|
|00003000| 73 74 20 73 65 74 20 62 | 6f 74 68 20 6f 66 20 74 |st set b|oth of t|
|00003010| 68 6f 73 65 20 76 61 72 | 69 61 62 6c 65 73 20 69 |hose var|iables i|
|00003020| 6e 20 6f 72 64 65 72 20 | 66 6f 72 20 70 72 6f 63 |n order |for proc|
|00003030| 65 64 75 72 65 73 20 6c | 69 6b 65 20 4f 75 74 4c |edures l|ike OutL|
|00003040| 69 6e 65 20 61 6e 64 20 | 62 43 52 20 74 6f 20 75 |ine and |bCR to u|
|00003050| 6e 64 65 72 73 74 61 6e | 64 20 77 68 69 63 68 20 |nderstan|d which |
|00003060| 6e 6f 64 65 20 74 6f 20 | 77 6f 72 6b 20 77 69 74 |node to |work wit|
|00003070| 68 2e 0d ff 00 0c 00 00 | 0c 00 00 0e 00 78 09 00 |h.......|.....x..|
|00003080| 00 03 00 01 0d ff 00 06 | 00 00 0c 00 00 0e 00 a1 |........|........|
|00003090| 52 65 73 53 68 61 72 65 | 64 3a 20 54 68 69 73 20 |ResShare|d: This |
|000030a0| 69 6e 74 65 67 65 72 20 | 69 73 20 74 68 65 20 72 |integer |is the r|
|000030b0| 65 73 6f 75 72 63 65 20 | 66 69 6c 65 20 72 65 66 |esource |file ref|
|000030c0| 65 72 65 6e 63 65 20 6e | 75 6d 62 65 72 20 66 6f |erence n|umber fo|
|000030d0| 72 20 74 68 65 20 48 65 | 72 6d 65 73 20 53 68 61 |r the He|rmes Sha|
|000030e0| 72 65 64 20 66 69 6c 65 | 2e 20 20 59 6f 75 20 6d |red file|.  You m|
|000030f0| 61 79 20 6e 6f 74 20 63 | 6c 6f 73 65 20 74 68 69 |ay not c|lose thi|
|00003100| 73 20 66 69 6c 65 2c 20 | 62 75 74 20 66 65 65 6c |s file, |but feel|
|00003110| 20 66 72 65 65 20 74 6f | 20 72 65 61 64 20 61 6e | free to| read an|
|00003120| 64 20 77 72 69 74 65 20 | 66 72 6f 6d 20 69 74 2e |d write |from it.|
|00003130| 0d ff 00 0c 00 00 0c 01 | 00 0e 00 0b 0c 00 00 0e |........|........|
|00003140| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 ff 44 61 |........|......Da|
|00003150| 74 61 53 68 61 72 65 64 | 3a 20 54 68 69 73 20 69 |taShared|: This i|
|00003160| 6e 74 65 67 65 72 20 69 | 73 20 74 68 65 20 64 61 |nteger i|s the da|
|00003170| 74 61 20 66 6f 72 6b 20 | 66 69 6c 65 20 72 65 66 |ta fork |file ref|
|00003180| 65 72 65 6e 63 65 20 6e | 75 6d 62 65 72 20 66 6f |erence n|umber fo|
|00003190| 72 20 74 68 65 20 48 65 | 72 6d 65 73 20 53 68 61 |r the He|rmes Sha|
|000031a0| 72 65 64 20 66 69 6c 65 | 2e 20 20 54 68 65 20 55 |red file|.  The U|
|000031b0| 73 65 72 52 65 63 20 73 | 74 72 75 63 74 75 72 65 |serRec s|tructure|
|000031c0| 20 66 6f 75 6e 64 20 69 | 6e 20 74 68 65 20 48 65 | found i|n the He|
|000031d0| 72 6d 48 65 61 64 65 72 | 73 2e 70 20 66 69 6c 65 |rmHeader|s.p file|
|000031e0| 20 69 73 20 73 74 6f 72 | 65 64 20 68 65 72 65 20 | is stor|ed here |
|000031f0| 63 6f 6e 73 65 63 75 74 | 69 76 65 6c 79 20 62 79 |consecut|ively by|
|00003200| 20 75 73 65 72 20 6e 75 | 6d 62 65 72 2e 20 20 46 | user nu|mber.  F|
|00003210| 65 65 6c 20 66 72 65 65 | 20 74 6f 20 72 65 61 64 |eel free| to read|
|00003220| 20 61 6e 64 20 77 72 69 | 74 65 20 66 72 6f 6d 20 | and wri|te from |
|00003230| 74 68 69 73 20 66 69 6c | 65 2e 20 20 44 6f 20 6e |this fil|e.  Do n|
|00003240| 6f 74 20 63 6c 6f 73 65 | 20 69 74 2e 0d ff 00 0c |ot close| it.....|
|00003250| 00 00 0c 01 00 0e 00 0c | 0c 00 00 0e 00 01 0d ff |........|........|
|00003260| 00 06 00 00 09 00 00 03 | 00 01 0d ff 00 06 00 00 |........|........|
|00003270| 09 00 00 03 00 f8 48 53 | 79 73 74 50 74 72 3a 20 |......HS|ystPtr: |
|00003280| 54 68 69 73 20 69 73 20 | 61 20 70 6f 69 6e 74 65 |This is |a pointe|
|00003290| 72 20 69 64 65 6e 74 69 | 63 61 6c 20 74 6f 20 74 |r identi|cal to t|
|000032a0| 68 65 20 69 64 65 6e 74 | 69 63 61 6c 6c 79 20 6e |he ident|ically n|
|000032b0| 61 6d 65 64 20 6f 6e 65 | 20 70 61 73 73 65 64 20 |amed one| passed |
|000032c0| 74 6f 20 73 79 73 6f 70 | 20 65 78 74 65 72 6e 61 |to sysop| externa|
|000032d0| 6c 73 2e 20 20 46 6f 72 | 20 61 20 6c 69 73 74 69 |ls.  For| a listi|
|000032e0| 6e 67 20 6f 66 20 74 68 | 65 20 66 69 65 6c 64 73 |ng of th|e fields|
|000032f0| 20 69 6e 20 74 68 69 73 | 20 72 65 63 6f 72 64 2c | in this| record,|
|00003300| 20 73 65 61 72 63 68 20 | 66 6f 72 20 69 74 20 69 | search |for it i|
|00003310| 6e 20 74 68 65 20 48 65 | 72 6d 48 65 61 64 65 72 |n the He|rmHeader|
|00003320| 73 2e 70 20 66 69 6c 65 | 2e 20 20 54 68 69 73 20 |s.p file|.  This |
|00003330| 72 65 63 6f 72 64 20 63 | 6f 6e 74 61 69 6e 73 20 |record c|ontains |
|00003340| 74 68 65 20 66 69 65 6c | 64 73 20 73 65 74 20 62 |the fiel|ds set b|
|00003350| 79 20 74 68 65 20 4f 70 | 74 69 6f 6e 73 20 73 79 |y the Op|tions sy|
|00003360| 73 6f 70 20 65 78 74 65 | 72 6e 61 6c 2e 0d 00 0c |sop exte|rnal....|
|00003370| 00 00 0c 01 00 0e 00 09 | 0c 00 00 0e 00 01 0d ff |........|........|
|00003380| 00 06 00 00 0c 00 00 0e | 01 05 48 4d 44 65 73 63 |........|..HMDesc|
|00003390| 50 74 72 3a 20 54 68 69 | 73 20 69 73 20 61 20 70 |Ptr: Thi|s is a p|
|000033a0| 6f 69 6e 74 65 72 20 69 | 64 65 6e 74 69 63 61 6c |ointer i|dentical|
|000033b0| 20 74 6f 20 74 68 65 20 | 69 64 65 6e 74 69 63 61 | to the |identica|
|000033c0| 6c 6c 79 20 6e 61 6d 65 | 64 20 6f 6e 65 20 70 61 |lly name|d one pa|
|000033d0| 73 73 65 64 20 74 6f 20 | 73 79 73 6f 70 20 65 78 |ssed to |sysop ex|
|000033e0| 74 65 72 6e 61 6c 73 2e | 20 20 46 6f 72 20 61 20 |ternals.|  For a |
|000033f0| 6c 69 73 74 69 6e 67 20 | 6f 66 20 74 68 65 20 66 |listing |of the f|
|00003400| 69 65 6c 64 73 20 69 6e | 20 74 68 69 73 20 72 65 |ields in| this re|
|00003410| 63 6f 72 64 2c 20 73 65 | 61 72 63 68 20 66 6f 72 |cord, se|arch for|
|00003420| 20 69 74 20 69 6e 20 74 | 68 65 20 48 65 72 6d 48 | it in t|he HermH|
|00003430| 65 61 64 65 72 73 2e 70 | 20 66 69 6c 65 2e 20 20 |eaders.p| file.  |
|00003440| 54 68 69 73 20 72 65 63 | 6f 72 64 20 63 6f 6e 74 |This rec|ord cont|
|00003450| 61 69 6e 73 20 74 68 65 | 20 66 69 65 6c 64 73 20 |ains the| fields |
|00003460| 73 65 74 20 69 6e 20 74 | 68 65 20 4d 65 73 73 61 |set in t|he Messa|
|00003470| 67 65 73 20 61 72 65 61 | 20 75 6e 64 65 72 20 74 |ges area| under t|
|00003480| 68 65 20 53 79 73 6f 70 | 20 6d 65 6e 75 2e 0d ff |he Sysop| menu...|
|00003490| 00 0c 00 00 0c 01 00 0e | 00 0b 0c 00 00 0e 00 01 |........|........|
|000034a0| 0d ff 00 06 00 00 0c 00 | 00 0e 01 0b 48 44 69 72 |........|....HDir|
|000034b0| 44 61 74 61 50 74 72 3a | 20 54 68 69 73 20 69 73 |DataPtr:| This is|
|000034c0| 20 61 20 70 6f 69 6e 74 | 65 72 20 69 64 65 6e 74 | a point|er ident|
|000034d0| 69 63 61 6c 20 74 6f 20 | 74 68 65 20 69 64 65 6e |ical to |the iden|
|000034e0| 74 69 63 61 6c 6c 79 20 | 6e 61 6d 65 64 20 6f 6e |tically |named on|
|000034f0| 65 20 70 61 73 73 65 64 | 20 74 6f 20 73 79 73 6f |e passed| to syso|
|00003500| 70 20 65 78 74 65 72 6e | 61 6c 73 2e 20 20 46 6f |p extern|als.  Fo|
|00003510| 72 20 61 20 6c 69 73 74 | 69 6e 67 20 6f 66 20 74 |r a list|ing of t|
|00003520| 68 65 20 66 69 65 6c 64 | 73 20 69 6e 20 74 68 69 |he field|s in thi|
|00003530| 73 20 72 65 63 6f 72 64 | 2c 20 73 65 61 72 63 68 |s record|, search|
|00003540| 20 66 6f 72 20 69 74 20 | 69 6e 20 74 68 65 20 48 | for it |in the H|
|00003550| 65 72 6d 48 65 61 64 65 | 72 73 2e 70 20 66 69 6c |ermHeade|rs.p fil|
|00003560| 65 2e 20 20 54 68 69 73 | 20 72 65 63 6f 72 64 20 |e.  This| record |
|00003570| 63 6f 6e 74 61 69 6e 73 | 20 74 68 65 20 66 69 65 |contains| the fie|
|00003580| 6c 64 73 20 73 65 74 20 | 62 79 20 74 68 65 20 54 |lds set |by the T|
|00003590| 72 61 6e 73 66 65 72 73 | 20 63 6f 6d 6d 61 6e 64 |ransfers| command|
|000035a0| 20 75 6e 64 65 72 20 74 | 68 65 20 53 79 73 6f 70 | under t|he Sysop|
|000035b0| 20 6d 65 6e 75 2e 0d ff | 00 0c 00 00 0c 01 00 0e | menu...|........|
|000035c0| 00 0d 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|000035d0| 00 0e 00 f8 48 47 46 69 | 6c 65 50 74 72 3a 20 54 |....HGFi|lePtr: T|
|000035e0| 68 69 73 20 69 73 20 61 | 20 70 6f 69 6e 74 65 72 |his is a| pointer|
|000035f0| 20 69 64 65 6e 74 69 63 | 61 6c 20 74 6f 20 74 68 | identic|al to th|
|00003600| 65 20 69 64 65 6e 74 69 | 63 61 6c 6c 79 20 6e 61 |e identi|cally na|
|00003610| 6d 65 64 20 6f 6e 65 20 | 70 61 73 73 65 64 20 74 |med one |passed t|
|00003620| 6f 20 73 79 73 6f 70 20 | 65 78 74 65 72 6e 61 6c |o sysop |external|
|00003630| 73 2e 20 20 46 6f 72 20 | 61 20 6c 69 73 74 69 6e |s.  For |a listin|
|00003640| 67 20 6f 66 20 74 68 65 | 20 66 69 65 6c 64 73 20 |g of the| fields |
|00003650| 69 6e 20 74 68 69 73 20 | 72 65 63 6f 72 64 2c 20 |in this |record, |
|00003660| 73 65 61 72 63 68 20 66 | 6f 72 20 69 74 20 69 6e |search f|or it in|
|00003670| 20 74 68 65 20 48 65 72 | 6d 48 65 61 64 65 72 73 | the Her|mHeaders|
|00003680| 2e 70 20 66 69 6c 65 2e | 20 20 54 68 69 73 20 72 |.p file.|  This r|
|00003690| 65 63 6f 72 64 20 63 6f | 6e 74 61 69 6e 73 20 74 |ecord co|ntains t|
|000036a0| 68 65 20 66 69 65 6c 64 | 73 20 73 65 74 20 62 79 |he field|s set by|
|000036b0| 20 74 68 65 20 47 46 69 | 6c 65 73 20 73 79 73 6f | the GFi|les syso|
|000036c0| 70 20 65 78 74 65 72 6e | 61 6c 2e 0d 00 0c 00 00 |p extern|al......|
|000036d0| 0c 01 00 0e 00 0b 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|000036e0| 00 00 0c 00 00 0e 00 a0 | 66 69 6c 65 73 50 61 74 |........|filesPat|
|000036f0| 68 3a 20 54 68 69 73 20 | 69 73 20 61 20 70 6f 69 |h: This |is a poi|
|00003700| 6e 74 65 72 20 74 6f 20 | 74 68 65 20 66 75 6c 6c |nter to |the full|
|00003710| 20 70 61 74 68 6e 61 6d | 65 20 74 6f 20 74 68 65 | pathnam|e to the|
|00003720| 20 48 65 72 6d 65 73 20 | 46 69 6c 65 73 20 66 6f | Hermes |Files fo|
|00003730| 6c 64 65 72 2e 20 20 46 | 6f 72 20 69 6e 73 74 61 |lder.  F|or insta|
|00003740| 6e 63 65 2c 20 d2 48 61 | 72 64 20 44 72 69 76 65 |nce, .Ha|rd Drive|
|00003750| 3a 42 42 53 3a 48 65 72 | 6d 65 73 20 46 69 6c 65 |:BBS:Her|mes File|
|00003760| 73 3a d3 20 77 6f 75 6c | 64 20 62 65 20 61 20 70 |s:. woul|d be a p|
|00003770| 6f 73 73 69 62 6c 65 20 | 76 61 6c 75 65 20 66 6f |ossible |value fo|
|00003780| 72 20 74 68 69 73 2e 0d | 00 0c 00 00 0c 01 00 0e |r this..|........|
|00003790| 00 0b 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|000037a0| 00 0e 00 af 48 65 72 6d | 55 73 65 72 73 3a 20 54 |....Herm|Users: T|
|000037b0| 68 69 73 20 66 69 65 6c | 64 20 69 73 20 69 6e 63 |his fiel|d is inc|
|000037c0| 6c 75 64 65 64 20 66 6f | 72 20 63 6f 6e 76 65 6e |luded fo|r conven|
|000037d0| 69 65 6e 63 65 2e 20 20 | 49 74 20 69 73 20 61 20 |ience.  |It is a |
|000037e0| 68 61 6e 64 6c 65 20 74 | 6f 20 61 6e 20 69 6e 64 |handle t|o an ind|
|000037f0| 65 78 20 6f 66 20 61 6c | 6c 20 75 73 65 72 73 20 |ex of al|l users |
|00003800| 6f 6e 20 74 68 65 20 73 | 79 73 74 65 6d 2e 20 20 |on the s|ystem.  |
|00003810| 54 68 65 20 61 63 74 75 | 61 6c 20 73 74 72 75 63 |The actu|al struc|
|00003820| 74 75 72 65 73 20 75 73 | 65 64 20 63 61 6e 20 62 |tures us|ed can b|
|00003830| 65 20 66 6f 75 6e 64 20 | 69 6e 20 74 68 65 20 48 |e found |in the H|
|00003840| 65 72 6d 48 65 61 64 65 | 72 73 2e 70 20 66 69 6c |ermHeade|rs.p fil|
|00003850| 65 2e 0d ff 00 0c 00 00 | 0c 01 00 0e 00 0b 0c 00 |e.......|........|
|00003860| 00 0e 00 01 0d ff 00 06 | 00 00 0c 00 00 0e 00 eb |........|........|
|00003870| 6e 3a 20 54 68 69 73 20 | 31 30 20 70 6f 69 6e 74 |n: This |10 point|
|00003880| 65 72 20 61 72 72 61 79 | 20 63 6f 6e 74 61 69 6e |er array| contain|
|00003890| 73 20 6f 6e 65 20 70 6f | 69 6e 74 65 72 20 66 6f |s one po|inter fo|
|000038a0| 72 20 65 61 63 68 20 6e | 6f 64 65 2e 20 20 54 68 |r each n|ode.  Th|
|000038b0| 65 79 20 61 72 65 20 69 | 6e 20 6f 72 64 65 72 2c |ey are i|n order,|
|000038c0| 20 61 6e 64 20 79 6f 75 | 20 73 68 6f 75 6c 64 20 | and you| should |
|000038d0| 6e 6f 74 20 75 73 65 20 | 74 68 65 20 66 69 65 6c |not use |the fiel|
|000038e0| 64 73 20 61 62 6f 76 65 | 20 74 68 65 20 76 61 6c |ds above| the val|
|000038f0| 75 65 20 6f 66 20 74 6f | 74 61 6c 4e 6f 64 65 73 |ue of to|talNodes|
|00003900| 2e 20 20 54 68 65 79 20 | 70 6f 69 6e 74 20 74 6f |.  They |point to|
|00003910| 20 74 68 65 20 76 61 72 | 69 61 62 6c 65 73 20 73 | the var|iables s|
|00003920| 74 72 75 63 74 75 72 65 | 20 48 65 72 6d 55 73 65 |tructure| HermUse|
|00003930| 72 47 6c 6f 62 73 52 65 | 63 20 66 6f 75 6e 64 20 |rGlobsRe|c found |
|00003940| 69 6e 20 74 68 65 20 48 | 65 72 6d 48 65 61 64 65 |in the H|ermHeade|
|00003950| 72 73 2e 70 20 66 69 6c | 65 2e 0d ff 00 18 00 00 |rs.p fil|e.......|
|00003960| 0c 01 00 0e 00 03 0c 00 | 00 0e 00 b9 0c 01 00 0e |........|........|
|00003970| 00 c9 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|00003980| 00 0e 01 b2 70 72 6f 63 | 73 3a 20 54 68 69 73 20 |....proc|s: This |
|00003990| 30 2d 62 61 73 65 64 20 | 61 72 72 61 79 20 69 73 |0-based |array is|
|000039a0| 20 61 20 76 61 72 69 61 | 62 6c 65 20 6c 65 6e 67 | a varia|ble leng|
|000039b0| 74 68 20 6c 69 73 74 20 | 6f 66 20 70 6f 69 6e 74 |th list |of point|
|000039c0| 65 72 73 20 74 6f 20 70 | 72 6f 63 65 64 75 72 65 |ers to p|rocedure|
|000039d0| 73 2e 20 20 41 74 20 74 | 68 65 20 63 75 72 72 65 |s.  At t|he curre|
|000039e0| 6e 74 20 74 69 6d 65 2c | 20 74 68 65 72 65 20 61 |nt time,| there a|
|000039f0| 72 65 20 31 33 20 61 76 | 61 69 6c 61 62 6c 65 20 |re 13 av|ailable |
|00003a00| 70 72 6f 63 65 64 75 72 | 65 73 20 79 6f 75 20 63 |procedur|es you c|
|00003a10| 61 6e 20 63 61 6c 6c 20 | 69 6e 20 48 65 72 6d 65 |an call |in Herme|
|00003a20| 73 20 65 61 63 68 20 6f | 66 20 77 68 69 63 68 20 |s each o|f which |
|00003a30| 61 72 65 20 64 65 66 69 | 6e 65 64 20 6c 61 74 65 |are defi|ned late|
|00003a40| 72 20 69 6e 20 74 68 69 | 73 20 64 6f 63 75 6d 65 |r in thi|s docume|
|00003a50| 6e 74 2e 20 20 45 61 63 | 68 20 70 72 6f 63 65 64 |nt.  Eac|h proced|
|00003a60| 75 72 65 20 68 61 73 20 | 61 20 d2 73 65 6c 65 63 |ure has |a .selec|
|00003a70| 74 6f 72 d3 20 77 68 69 | 63 68 20 69 73 20 61 6e |tor. whi|ch is an|
|00003a80| 20 69 6e 64 65 78 20 69 | 6e 74 6f 20 74 68 69 73 | index i|nto this|
|00003a90| 20 61 72 72 61 79 2e 20 | 20 46 75 72 74 68 65 72 | array. | Further|
|00003aa0| 20 70 72 6f 63 65 64 75 | 72 65 73 20 77 69 6c 6c | procedu|res will|
|00003ab0| 20 62 65 20 61 64 64 65 | 64 20 69 6e 20 66 75 74 | be adde|d in fut|
|00003ac0| 75 72 65 20 76 65 72 73 | 69 6f 6e 73 2e 20 20 54 |ure vers|ions.  T|
|00003ad0| 68 65 73 65 20 61 64 64 | 69 74 69 6f 6e 73 20 77 |hese add|itions w|
|00003ae0| 69 6c 6c 20 6e 6f 74 20 | 61 66 66 65 63 74 20 61 |ill not |affect a|
|00003af0| 6c 72 65 61 64 79 20 65 | 78 69 73 74 69 6e 67 20 |lready e|xisting |
|00003b00| 65 78 74 65 72 6e 61 6c | 73 2e 20 20 44 6f 20 6e |external|s.  Do n|
|00003b10| 6f 74 20 72 65 6c 79 20 | 6f 6e 20 74 68 65 20 73 |ot rely |on the s|
|00003b20| 69 7a 65 20 6f 66 20 74 | 68 65 20 55 73 65 72 58 |ize of t|he UserX|
|00003b30| 49 52 65 63 2e 0d 00 12 | 00 00 0c 01 00 0e 00 07 |IRec....|........|
|00003b40| 0c 00 00 0e 01 07 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|00003b50| 00 00 0c 00 00 0e 00 00 | 01 da 01 00 00 00 00 00 |........|........|
|00003b60| aa ac 00 00 00 14 00 63 | 88 b4 00 0a 00 8b 00 89 |.......c|........|
|00003b70| 00 e9 01 f7 ff ff ff ff | 00 12 48 65 72 6d 65 73 |........|..Hermes|
|00003b80| 20 50 72 6f 63 65 64 75 | 72 65 73 0d 00 0c 00 00 | Procedu|res.....|
|00003b90| 0c 01 00 0e 00 11 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|00003ba0| 00 00 0c 00 00 0e 00 00 | 01 da 00 00 00 00 00 00 |........|........|
|00003bb0| aa ac 00 00 00 20 00 63 | 88 b4 00 0a 00 00 00 00 |..... .c|........|
|00003bc0| 00 00 00 00 ff ff ff ff | 01 59 54 68 65 20 75 73 |........|.YThe us|
|00003bd0| 65 72 20 65 78 74 65 72 | 6e 61 6c 73 20 69 6e 74 |er exter|nals int|
|00003be0| 65 72 66 61 63 65 20 70 | 72 6f 76 69 64 65 73 20 |erface p|rovides |
|00003bf0| 6d 61 6e 79 20 70 72 6f | 63 65 64 75 72 65 73 20 |many pro|cedures |
|00003c00| 77 68 69 63 68 20 79 6f | 75 20 63 61 6e 20 63 61 |which yo|u can ca|
|00003c10| 6c 6c 2e 20 20 54 68 65 | 73 65 20 70 72 6f 63 65 |ll.  The|se proce|
|00003c20| 64 75 72 65 73 20 61 72 | 65 20 69 6e 73 69 64 65 |dures ar|e inside|
|00003c30| 20 48 65 72 6d 65 73 20 | 61 6e 64 20 77 69 6c 6c | Hermes |and will|
|00003c40| 20 61 63 74 20 61 73 20 | 69 66 20 74 68 65 79 20 | act as |if they |
|00003c50| 68 61 64 20 62 65 65 6e | 20 63 61 6c 6c 65 64 20 |had been| called |
|00003c60| 62 79 20 48 65 72 6d 65 | 73 2e 20 20 53 65 76 65 |by Herme|s.  Seve|
|00003c70| 72 61 6c 20 6f 66 20 74 | 68 65 73 65 20 70 72 6f |ral of t|hese pro|
|00003c80| 63 65 64 75 72 65 73 20 | 61 72 65 20 64 65 6d 6f |cedures |are demo|
|00003c90| 6e 73 74 72 61 74 65 64 | 20 69 6e 20 74 68 65 20 |nstrated| in the |
|00003ca0| 55 70 64 61 74 65 20 50 | 68 6f 6e 65 20 73 61 6d |Update P|hone sam|
|00003cb0| 70 6c 65 20 65 78 74 65 | 72 6e 61 6c 2e 20 20 46 |ple exte|rnal.  F|
|00003cc0| 69 72 73 74 2c 20 6c 65 | 74 d5 73 20 74 61 6b 65 |irst, le|t.s take|
|00003cd0| 20 61 20 6c 6f 6f 6b 20 | 61 74 20 74 68 65 20 62 | a look |at the b|
|00003ce0| 43 52 20 70 72 6f 63 65 | 64 75 72 65 2e 20 20 49 |CR proce|dure.  I|
|00003cf0| 74 20 69 73 20 64 65 66 | 69 6e 65 64 20 61 73 20 |t is def|ined as |
|00003d00| 66 6f 6c 6c 6f 77 73 20 | 69 6e 20 74 68 65 20 48 |follows |in the H|
|00003d10| 65 72 6d 48 65 61 64 65 | 72 73 2e 70 20 66 69 6c |ermHeade|rs.p fil|
|00003d20| 65 3a 0d ff 00 0c 00 00 | 0c 00 00 0e 01 00 0c 00 |e:......|........|
|00003d30| 00 0e 00 34 20 70 72 6f | 63 65 64 75 72 65 20 62 |...4 pro|cedure b|
|00003d40| 43 52 20 28 74 68 65 52 | 6f 75 74 3a 20 50 72 6f |CR (theR|out: Pro|
|00003d50| 63 50 74 72 29 3b 20 20 | 20 7b 73 65 6c 65 63 74 |cPtr);  | {select|
|00003d60| 6f 72 20 3d 20 30 7d 0d | 00 12 00 00 09 00 00 03 |or = 0}.|........|
|00003d70| 00 01 09 01 00 03 00 0a | 09 00 00 03 00 01 0d ff |........|........|
|00003d80| 00 06 00 00 0c 00 00 0e | 02 ac 54 68 69 73 20 70 |........|..This p|
|00003d90| 72 6f 63 65 64 75 72 65 | 20 61 63 74 73 20 6c 69 |rocedure| acts li|
|00003da0| 6b 65 20 70 72 65 73 73 | 69 6e 67 20 61 20 72 65 |ke press|ing a re|
|00003db0| 74 75 72 6e 2e 20 20 49 | 74 20 77 69 6c 6c 20 63 |turn.  I|t will c|
|00003dc0| 61 75 73 65 20 74 6f 20 | 74 68 65 20 63 75 72 73 |ause to |the curs|
|00003dd0| 6f 72 20 74 6f 20 6d 6f | 76 65 20 64 6f 77 6e 20 |or to mo|ve down |
|00003de0| 6f 6e 65 20 6c 69 6e 65 | 20 61 6e 64 20 62 61 63 |one line| and bac|
|00003df0| 6b 20 74 6f 20 68 6f 72 | 69 7a 6f 6e 74 61 6c 20 |k to hor|izontal |
|00003e00| 70 6f 73 69 74 69 6f 6e | 20 7a 65 72 6f 2e 20 20 |position| zero.  |
|00003e10| 49 66 20 74 68 65 20 63 | 75 72 73 6f 72 20 69 73 |If the c|ursor is|
|00003e20| 20 61 74 20 74 68 65 20 | 62 6f 74 74 6f 6d 20 6f | at the |bottom o|
|00003e30| 66 20 74 68 65 20 73 63 | 72 65 65 6e 2c 20 74 68 |f the sc|reen, th|
|00003e40| 65 20 73 63 72 65 65 6e | 20 77 69 6c 6c 20 73 63 |e screen| will sc|
|00003e50| 72 6f 6c 6c 20 75 70 2e | 20 20 54 68 69 73 20 70 |roll up.|  This p|
|00003e60| 72 6f 63 65 64 75 72 65 | 20 61 75 74 6f 6d 61 74 |rocedure| automat|
|00003e70| 69 63 61 6c 6c 79 20 6f | 75 74 70 75 73 20 74 68 |ically o|utpus th|
|00003e80| 65 20 6e 65 63 65 73 73 | 61 72 79 20 63 68 61 72 |e necess|ary char|
|00003e90| 61 63 74 65 72 73 20 74 | 6f 20 72 65 70 72 6f 64 |acters t|o reprod|
|00003ea0| 75 63 65 20 74 68 69 73 | 20 6f 6e 20 74 68 65 20 |uce this| on the |
|00003eb0| 72 65 6d 6f 74 65 20 73 | 63 72 65 65 6e 2e 20 20 |remote s|creen.  |
|00003ec0| 53 70 65 63 69 66 69 63 | 61 6c 6c 79 2c 20 61 20 |Specific|ally, a |
|00003ed0| 63 61 72 72 69 61 67 65 | 20 72 65 74 75 72 6e 20 |carriage| return |
|00003ee0| 28 31 33 29 20 66 6f 6c | 6c 6f 77 65 64 20 62 79 |(13) fol|lowed by|
|00003ef0| 20 61 20 6c 69 6e 65 20 | 66 65 65 64 28 31 30 29 | a line |feed(10)|
|00003f00| 2e 20 20 53 69 6e 63 65 | 20 74 68 65 72 65 20 69 |.  Since| there i|
|00003f10| 73 20 6e 6f 20 6a 75 6d | 70 20 74 61 62 6c 65 20 |s no jum|p table |
|00003f20| 6c 69 6b 65 20 69 6e 20 | 61 20 6e 6f 72 6d 61 6c |like in |a normal|
|00003f30| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 2c 20 74 68 | applica|tion, th|
|00003f40| 65 20 70 72 6f 63 73 20 | 66 69 65 6c 64 20 6f 66 |e procs |field of|
|00003f50| 20 74 68 65 20 55 73 65 | 72 58 49 72 65 63 20 73 | the Use|rXIrec s|
|00003f60| 65 72 76 65 73 20 61 73 | 20 6f 75 72 20 70 73 65 |erves as| our pse|
|00003f70| 75 64 6f 20 6a 75 6d 70 | 20 74 61 62 6c 65 2e 20 |udo jump| table. |
|00003f80| 20 57 68 65 6e 20 79 6f | 75 20 63 61 6c 6c 20 62 | When yo|u call b|
|00003f90| 43 52 2c 20 79 6f 75 20 | 6d 75 73 74 20 70 61 73 |CR, you |must pas|
|00003fa0| 73 20 69 74 73 20 61 64 | 64 72 65 73 73 20 61 73 |s its ad|dress as|
|00003fb0| 20 74 68 65 20 6c 61 73 | 74 20 70 61 72 61 6d 65 | the las|t parame|
|00003fc0| 74 65 72 2e 20 20 54 68 | 65 20 69 6e 6c 69 6e 65 |ter.  Th|e inline|
|00003fd0| 20 63 6f 64 65 20 69 6e | 20 48 65 72 6d 48 65 61 | code in| HermHea|
|00003fe0| 64 65 72 73 2e 70 20 77 | 69 6c 6c 20 68 61 6e 64 |ders.p w|ill hand|
|00003ff0| 6c 65 20 74 68 65 20 63 | 61 6c 6c 20 66 72 6f 6d |le the c|all from|
|00004000| 20 74 68 65 72 65 2e 20 | 20 53 6f 2c 20 79 6f 75 | there. | So, you|
|00004010| 20 77 6f 75 6c 64 20 64 | 6f 20 74 68 69 73 20 74 | would d|o this t|
|00004020| 6f 20 63 61 6c 6c 20 74 | 68 65 20 70 72 6f 63 65 |o call t|he proce|
|00004030| 64 75 72 65 3a 0d 00 12 | 00 00 0c 00 00 0e 01 00 |dure:...|........|
|00004040| 0c 00 00 0e 02 00 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|00004050| 00 00 0c 00 00 0e 00 12 | 20 20 20 62 43 52 28 70 |........|   bCR(p|
|00004060| 72 6f 63 73 5b 30 5d 29 | 3b 0d 00 12 00 00 0c 00 |rocs[0])|;.......|
|00004070| 00 0e 00 01 09 00 00 03 | 00 11 0c 00 00 0e 00 01 |........|........|
|00004080| 0d ff 00 06 00 00 0c 00 | 00 0e 00 d5 45 61 63 68 |........|....Each|
|00004090| 20 70 72 6f 63 65 64 75 | 72 65 20 69 73 20 6c 69 | procedu|re is li|
|000040a0| 73 74 65 64 20 61 74 20 | 74 68 65 20 62 6f 74 74 |sted at |the bott|
|000040b0| 6f 6d 20 6f 66 20 48 65 | 72 6d 48 65 61 64 65 72 |om of He|rmHeader|
|000040c0| 73 2e 70 20 77 69 74 68 | 20 69 74 73 20 61 70 70 |s.p with| its app|
|000040d0| 72 6f 70 72 69 61 74 65 | 20 73 65 6c 65 63 74 6f |ropriate| selecto|
|000040e0| 72 2e 20 20 4a 75 73 74 | 20 70 61 73 73 20 50 72 |r.  Just| pass Pr|
|000040f0| 6f 63 73 5b 5d 20 77 69 | 74 68 20 74 68 61 74 20 |ocs[] wi|th that |
|00004100| 73 65 6c 65 63 74 6f 72 | 20 66 6f 72 20 74 68 65 |selector| for the|
|00004110| 52 6f 75 74 20 70 61 72 | 61 6d 65 74 65 72 2e 20 |Rout par|ameter. |
|00004120| 20 4e 6f 77 20 6c 65 74 | d5 73 20 74 61 6b 65 20 | Now let|.s take |
|00004130| 61 20 6c 6f 6f 6b 20 61 | 74 20 74 68 65 20 6f 74 |a look a|t the ot|
|00004140| 68 65 72 20 70 72 6f 63 | 65 64 75 72 65 73 20 61 |her proc|edures a|
|00004150| 76 61 69 6c 61 62 6c 65 | 20 74 6f 20 79 6f 75 2e |vailable| to you.|
|00004160| 0d ff 00 06 00 00 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|00004170| 00 00 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |........|........|
|00004180| 00 0e 00 6d 70 72 6f 63 | 65 64 75 72 65 20 4f 75 |...mproc|edure Ou|
|00004190| 74 4c 69 6e 65 20 28 67 | 6f 69 6e 67 4f 75 74 3a |tLine (g|oingOut:|
|000041a0| 20 73 74 72 32 35 35 3b | 20 4e 4c 61 74 42 65 67 | str255;| NLatBeg|
|000041b0| 69 6e 3a 20 62 6f 6f 6c | 65 61 6e 3b 20 74 79 70 |in: bool|ean; typ|
|000041c0| 65 4c 69 6e 65 3a 20 69 | 6e 74 65 67 65 72 3b 20 |eLine: i|nteger; |
|000041d0| 74 68 65 52 6f 75 74 3a | 20 50 72 6f 63 50 74 72 |theRout:| ProcPtr|
|000041e0| 29 3b 20 20 7b 73 65 6c | 65 63 74 6f 72 3d 31 7d |);  {sel|ector=1}|
|000041f0| 0d ff 00 12 00 00 09 01 | 00 03 00 09 09 00 00 03 |........|........|
|00004200| 00 6c 0c 00 00 0e 03 24 | 54 68 65 20 4f 75 74 4c |.l.....$|The OutL|
|00004210| 69 6e 65 20 70 72 6f 63 | 65 64 75 72 65 20 68 61 |ine proc|edure ha|
|00004220| 6e 64 6c 65 73 20 61 6c | 6d 6f 73 74 20 61 6c 6c |ndles al|most all|
|00004230| 20 63 68 61 72 61 63 74 | 65 72 20 6f 75 74 70 75 | charact|er outpu|
|00004240| 74 20 74 6f 20 74 68 65 | 20 75 73 65 72 20 73 63 |t to the| user sc|
|00004250| 72 65 65 6e 2e 20 20 49 | 74 20 6f 75 74 70 75 74 |reen.  I|t output|
|00004260| 73 20 74 68 65 20 73 74 | 72 69 6e 67 20 6f 75 74 |s the st|ring out|
|00004270| 20 74 68 65 20 70 6f 72 | 74 2c 20 64 72 61 77 73 | the por|t, draws|
|00004280| 20 69 74 20 6f 6e 20 74 | 68 65 20 73 63 72 65 65 | it on t|he scree|
|00004290| 6e 2c 20 70 75 74 73 20 | 69 74 20 69 6e 20 74 68 |n, puts |it in th|
|000042a0| 65 20 62 75 66 66 65 72 | 2c 20 61 6e 64 20 68 61 |e buffer|, and ha|
|000042b0| 6e 64 6c 65 73 20 41 4e | 53 49 20 66 6f 72 20 79 |ndles AN|SI for y|
|000042c0| 6f 75 2e 20 20 54 68 65 | 20 67 6f 69 6e 67 4f 75 |ou.  The| goingOu|
|000042d0| 74 20 70 61 72 61 6d 65 | 74 65 72 20 69 73 20 74 |t parame|ter is t|
|000042e0| 68 65 20 61 63 74 75 61 | 6c 20 74 65 78 74 20 79 |he actua|l text y|
|000042f0| 6f 75 20 77 61 6e 74 20 | 74 6f 20 6f 75 74 70 75 |ou want |to outpu|
|00004300| 74 2e 20 20 49 74 20 73 | 68 6f 75 6c 64 20 6e 6f |t.  It s|hould no|
|00004310| 74 20 63 6f 6e 74 61 69 | 6e 20 63 6f 6e 74 72 6f |t contai|n contro|
|00004320| 6c 20 63 68 61 72 61 63 | 74 65 72 73 2c 20 61 6e |l charac|ters, an|
|00004330| 64 20 73 68 6f 75 6c 64 | 20 62 65 20 6c 69 6d 69 |d should| be limi|
|00004340| 74 65 64 20 74 6f 20 73 | 74 61 6e 64 61 72 64 20 |ted to s|tandard |
|00004350| 74 65 78 74 2e 20 20 54 | 68 65 20 4e 4c 61 74 42 |text.  T|he NLatB|
|00004360| 65 67 69 6e 20 66 69 65 | 6c 64 20 69 73 20 6a 75 |egin fie|ld is ju|
|00004370| 73 74 20 61 20 63 6f 6e | 76 65 6e 69 65 6e 63 65 |st a con|venience|
|00004380| 2e 20 20 49 66 20 74 68 | 69 73 20 69 73 20 74 72 |.  If th|is is tr|
|00004390| 75 65 2c 20 74 68 65 20 | 62 43 52 20 70 72 6f 63 |ue, the |bCR proc|
|000043a0| 65 64 75 72 65 20 77 69 | 6c 6c 20 62 65 20 63 61 |edure wi|ll be ca|
|000043b0| 6c 6c 65 64 20 64 69 72 | 65 63 74 6c 79 20 62 65 |lled dir|ectly be|
|000043c0| 66 6f 72 65 20 6f 75 74 | 70 75 74 74 69 6e 67 20 |fore out|putting |
|000043d0| 74 68 65 20 74 65 78 74 | 20 69 6e 20 67 6f 69 6e |the text| in goin|
|000043e0| 67 4f 75 74 2e 20 20 54 | 68 65 20 74 79 70 65 4c |gOut.  T|he typeL|
|000043f0| 69 6e 65 20 66 69 65 6c | 64 20 72 65 70 72 65 73 |ine fiel|d repres|
|00004400| 65 6e 74 73 20 74 68 65 | 20 41 4e 53 49 20 63 6f |ents the| ANSI co|
|00004410| 6c 6f 72 20 66 6f 72 20 | 74 68 69 73 20 74 65 78 |lor for |this tex|
|00004420| 74 2e 20 20 49 66 20 74 | 68 69 73 20 66 69 65 6c |t.  If t|his fiel|
|00004430| 64 20 69 73 20 61 20 6e | 75 6d 62 65 72 20 66 72 |d is a n|umber fr|
|00004440| 6f 6d 20 30 2d 37 2c 20 | 74 68 65 20 74 65 78 74 |om 0-7, |the text|
|00004450| 20 77 69 6c 6c 20 62 65 | 20 64 72 61 77 6e 20 69 | will be| drawn i|
|00004460| 6e 20 74 68 65 20 75 73 | 65 72 20 63 6f 6c 6f 72 |n the us|er color|
|00004470| 20 63 6f 72 72 65 73 70 | 6f 6e 64 69 6e 67 20 74 | corresp|onding t|
|00004480| 6f 20 74 68 61 74 20 6e | 75 6d 62 65 72 2e 20 20 |o that n|umber.  |
|00004490| 49 66 20 69 74 20 69 73 | 20 65 71 75 61 6c 20 74 |If it is| equal t|
|000044a0| 6f 20 2d 31 2c 20 74 68 | 65 20 63 75 72 72 65 6e |o -1, th|e curren|
|000044b0| 74 20 41 4e 53 49 20 63 | 6f 6e 66 69 67 75 72 61 |t ANSI c|onfigura|
|000044c0| 74 69 6f 6e 20 77 69 6c | 6c 20 6e 6f 74 20 62 65 |tion wil|l not be|
|000044d0| 20 63 68 61 6e 67 65 64 | 2e 20 20 46 6f 72 20 6d | changed|.  For m|
|000044e0| 6f 72 65 20 63 6f 6d 70 | 6c 65 74 65 20 63 6f 6e |ore comp|lete con|
|000044f0| 74 72 6f 6c 20 6f 76 65 | 72 20 41 4e 53 49 2c 20 |trol ove|r ANSI, |
|00004500| 73 65 65 20 74 68 65 20 | 41 4e 53 49 43 6f 64 65 |see the |ANSICode|
|00004510| 20 70 72 6f 63 65 64 75 | 72 65 20 64 65 73 63 72 | procedu|re descr|
|00004520| 69 62 65 64 20 6c 61 74 | 65 72 2e 0d 00 30 00 00 |ibed lat|er...0..|
|00004530| 0c 00 00 0e 00 c1 0c 01 | 00 0e 00 c9 0c 00 00 0e |........|........|
|00004540| 01 53 0c 01 00 0e 01 5c | 0c 00 00 0e 01 e3 0c 01 |.S.....\|........|
|00004550| 00 0e 01 eb 0c 00 00 0e | 02 eb 0c 00 00 0e 00 01 |........|........|
|00004560| 0d ff 00 06 00 00 0c 00 | 00 0e 00 3e 70 72 6f 63 |........|...>proc|
|00004570| 65 64 75 72 65 20 48 61 | 6e 67 55 70 41 6e 64 52 |edure Ha|ngUpAndR|
|00004580| 65 73 65 74 20 28 74 68 | 65 52 6f 75 74 3a 20 50 |eset (th|eRout: P|
|00004590| 72 6f 63 50 74 72 29 3b | 20 20 20 7b 73 65 6c 65 |rocPtr);|   {sele|
|000045a0| 63 74 6f 72 20 3d 20 32 | 7d 0d 00 12 00 00 09 01 |ctor = 2|}.......|
|000045b0| 00 03 00 09 09 00 00 03 | 00 3d 0c 00 00 0e 00 da |........|.=......|
|000045c0| 54 68 69 73 20 70 72 6f | 63 65 64 75 72 65 20 68 |This pro|cedure h|
|000045d0| 61 73 20 6e 6f 20 70 61 | 72 61 6d 65 74 65 72 73 |as no pa|rameters|
|000045e0| 20 62 65 73 69 64 65 73 | 20 69 74 73 20 6a 75 6d | besides| its jum|
|000045f0| 70 20 76 65 63 74 6f 72 | 2e 20 20 43 61 6c 6c 20 |p vector|.  Call |
|00004600| 74 68 69 73 20 69 66 20 | 79 6f 75 20 77 61 6e 74 |this if |you want|
|00004610| 20 74 6f 20 66 6f 72 63 | 65 20 61 6e 20 69 6d 6d | to forc|e an imm|
|00004620| 65 64 69 61 74 65 20 6c | 6f 67 6f 66 66 20 61 6e |ediate l|ogoff an|
|00004630| 64 20 72 65 73 65 74 20 | 6f 66 20 74 68 65 20 63 |d reset |of the c|
|00004640| 75 72 72 65 6e 74 20 6e | 6f 64 65 2e 20 20 54 68 |urrent n|ode.  Th|
|00004650| 69 73 20 70 72 6f 63 65 | 64 75 72 65 73 20 68 61 |is proce|dures ha|
|00004660| 6e 64 6c 65 73 20 68 61 | 6e 67 69 6e 67 20 75 70 |ndles ha|nging up|
|00004670| 20 74 68 65 20 6d 6f 64 | 65 6d 20 61 6e 64 20 72 | the mod|em and r|
|00004680| 65 74 75 72 6e 69 6e 67 | 20 74 6f 20 77 61 69 74 |eturning| to wait|
|00004690| 69 6e 67 20 6d 6f 64 65 | 2e 0d 00 06 00 00 0c 00 |ing mode|........|
|000046a0| 00 0e 00 01 0d ff 00 06 | 00 00 0c 00 00 0e 00 4e |........|.......N|
|000046b0| 70 72 6f 63 65 64 75 72 | 65 20 50 72 6f 6d 70 74 |procedur|e Prompt|
|000046c0| 55 73 65 72 20 28 77 68 | 69 63 68 4e 6f 64 65 3a |User (wh|ichNode:|
|000046d0| 20 69 6e 74 65 67 65 72 | 3b 20 74 68 65 52 6f 75 | integer|; theRou|
|000046e0| 74 3a 20 50 72 6f 63 50 | 74 72 29 3b 20 20 20 7b |t: ProcP|tr);   {|
|000046f0| 73 65 6c 65 63 74 6f 72 | 20 3d 20 33 7d 0d 00 12 |selector| = 3}...|
|00004700| 00 00 09 01 00 03 00 09 | 09 00 00 03 00 4d 0c 00 |........|.....M..|
|00004710| 00 0e 03 ea 59 6f 75 20 | 77 69 6c 6c 20 72 61 72 |....You |will rar|
|00004720| 65 6c 79 20 75 73 65 20 | 74 68 69 73 20 70 72 6f |ely use |this pro|
|00004730| 63 65 64 75 72 65 20 64 | 69 72 65 63 74 6c 79 2e |cedure d|irectly.|
|00004740| 20 20 55 73 75 61 6c 6c | 79 2c 20 79 6f 75 20 77 |  Usuall|y, you w|
|00004750| 69 6c 6c 20 75 73 65 20 | 6f 6e 20 6f 66 20 74 68 |ill use |on of th|
|00004760| 65 20 70 72 6f 63 65 64 | 75 72 65 73 20 64 65 73 |e proced|ures des|
|00004770| 63 72 69 62 65 64 20 6c | 61 74 65 72 20 66 6f 72 |cribed l|ater for|
|00004780| 20 79 6f 75 72 20 70 72 | 6f 6d 70 74 73 2e 20 20 | your pr|ompts.  |
|00004790| 54 68 69 73 20 70 72 6f | 63 65 64 75 72 65 20 69 |This pro|cedure i|
|000047a0| 73 20 70 72 6f 76 69 64 | 65 64 20 6d 61 69 6e 6c |s provid|ed mainl|
|000047b0| 79 20 66 6f 72 20 65 78 | 74 72 65 6d 65 6c 79 20 |y for ex|tremely |
|000047c0| 63 6f 6d 70 6c 65 78 20 | 70 72 6f 6d 70 74 73 20 |complex |prompts |
|000047d0| 74 68 61 74 20 64 6f 20 | 6e 6f 74 20 66 69 74 20 |that do |not fit |
|000047e0| 69 6e 74 6f 20 61 6e 79 | 20 6f 66 20 74 68 65 20 |into any| of the |
|000047f0| 73 74 61 6e 64 61 72 64 | 20 63 61 74 65 67 6f 72 |standard| categor|
|00004800| 69 65 73 20 75 73 65 64 | 20 62 79 20 48 65 72 6d |ies used| by Herm|
|00004810| 65 73 2e 20 20 49 66 20 | 79 6f 75 20 63 61 6c 6c |es.  If |you call|
|00004820| 20 74 68 69 73 20 64 69 | 72 65 63 74 6c 79 2c 20 | this di|rectly, |
|00004830| 69 74 20 69 73 20 79 6f | 75 72 20 72 65 73 70 6f |it is yo|ur respo|
|00004840| 6e 73 69 62 69 6c 69 74 | 79 20 74 6f 20 73 65 74 |nsibilit|y to set|
|00004850| 20 74 68 65 20 66 69 65 | 6c 64 73 20 6f 66 20 74 | the fie|lds of t|
|00004860| 68 65 20 70 72 6f 6d 70 | 74 69 6e 67 20 72 65 63 |he promp|ting rec|
|00004870| 6f 72 64 20 74 68 61 74 | 20 63 61 6e 20 62 65 20 |ord that| can be |
|00004880| 66 6f 75 6e 64 20 69 6e | 20 74 68 65 20 48 65 72 |found in| the Her|
|00004890| 6d 48 65 61 64 65 72 73 | 20 66 69 6c 65 2e 20 20 |mHeaders| file.  |
|000048a0| 45 61 63 68 20 6e 6f 64 | 65 20 68 61 73 20 69 74 |Each nod|e has it|
|000048b0| 73 20 6f 77 6e 20 70 72 | 6f 6d 70 74 69 6e 67 20 |s own pr|ompting |
|000048c0| 72 65 63 6f 72 64 20 69 | 6e 20 61 20 76 61 72 69 |record i|n a vari|
|000048d0| 61 62 6c 65 20 6e 61 6d | 65 64 20 6d 79 50 72 6f |able nam|ed myPro|
|000048e0| 6d 70 74 20 77 68 69 63 | 68 20 79 6f 75 20 6d 61 |mpt whic|h you ma|
|000048f0| 79 20 66 65 65 6c 20 66 | 72 65 65 20 74 6f 20 6d |y feel f|ree to m|
|00004900| 6f 64 69 66 79 2e 20 20 | 57 68 65 6e 20 79 6f 75 |odify.  |When you|
|00004910| 20 63 61 6c 6c 20 61 6e | 79 20 70 72 6f 6d 70 74 | call an|y prompt|
|00004920| 69 6e 67 20 70 72 6f 63 | 65 64 75 72 65 2c 20 79 |ing proc|edure, y|
|00004930| 6f 75 20 73 68 6f 75 6c | 64 20 72 65 74 75 72 6e |ou shoul|d return|
|00004940| 20 74 6f 20 48 65 72 6d | 65 73 20 71 75 69 63 6b | to Herm|es quick|
|00004950| 6c 79 2e 20 20 59 6f 75 | 20 77 69 6c 6c 20 62 65 |ly.  You| will be|
|00004960| 20 63 61 6c 6c 65 64 20 | 61 67 61 69 6e 20 77 68 | called |again wh|
|00004970| 65 6e 20 74 68 65 20 70 | 72 6f 6d 70 74 20 68 61 |en the p|rompt ha|
|00004980| 73 20 62 65 65 6e 20 63 | 6f 6d 70 6c 65 74 65 64 |s been c|ompleted|
|00004990| 2e 20 20 49 66 20 79 6f | 75 20 72 65 63 65 69 76 |.  If yo|u receiv|
|000049a0| 65 20 69 64 6c 65 20 6d | 65 73 73 61 67 65 73 2c |e idle m|essages,|
|000049b0| 20 79 6f 75 20 77 69 6c | 6c 20 62 65 20 63 61 6c | you wil|l be cal|
|000049c0| 6c 65 64 20 64 75 72 69 | 6e 67 20 74 68 65 20 70 |led duri|ng the p|
|000049d0| 72 6f 6d 70 74 2c 20 62 | 75 74 20 79 6f 75 20 73 |rompt, b|ut you s|
|000049e0| 68 6f 75 6c 64 20 6e 6f | 74 20 74 61 6b 65 20 61 |hould no|t take a|
|000049f0| 6e 79 20 61 63 74 69 6f | 6e 73 20 6f 6e 20 61 20 |ny actio|ns on a |
|00004a00| 6e 6f 64 65 20 62 65 69 | 6e 67 20 70 72 6f 6d 70 |node bei|ng promp|
|00004a10| 74 65 64 2e 20 20 49 66 | 20 79 6f 75 20 74 68 69 |ted.  If| you thi|
|00004a20| 6e 6b 20 79 6f 75 20 6e | 65 65 64 20 74 68 69 73 |nk you n|eed this|
|00004a30| 20 6d 65 74 68 6f 64 2c | 20 73 65 65 20 74 68 65 | method,| see the|
|00004a40| 20 52 65 70 72 69 6e 74 | 50 72 6f 6d 70 74 20 70 | Reprint|Prompt p|
|00004a50| 72 6f 63 65 64 75 72 65 | 20 62 65 6c 6f 77 2e 20 |rocedure| below. |
|00004a60| 20 54 68 65 20 75 73 65 | 72 d5 73 20 69 6e 70 75 | The use|r.s inpu|
|00004a70| 74 20 74 6f 20 74 68 65 | 20 70 72 6f 6d 70 74 20 |t to the| prompt |
|00004a80| 77 69 6c 6c 20 62 65 20 | 63 6f 6e 74 61 69 6e 65 |will be |containe|
|00004a90| 64 20 69 6e 20 74 68 65 | 20 6e 6f 64 65 20 76 61 |d in the| node va|
|00004aa0| 72 69 61 62 6c 65 20 63 | 75 72 50 72 6f 6d 70 74 |riable c|urPrompt|
|00004ab0| 2e 20 20 53 65 65 20 74 | 68 65 20 55 70 64 61 74 |.  See t|he Updat|
|00004ac0| 65 20 50 68 6f 6e 65 20 | 65 78 74 65 72 6e 61 6c |e Phone |external|
|00004ad0| 20 66 6f 72 20 61 20 64 | 65 6d 6f 6e 73 74 72 61 | for a d|emonstra|
|00004ae0| 74 69 6f 6e 20 6f 66 20 | 68 6f 77 20 74 6f 20 70 |tion of |how to p|
|00004af0| 72 6f 6d 70 74 20 61 20 | 75 73 65 72 2e 0d 00 2a |rompt a |user...*|
|00004b00| 00 00 0c 00 00 0e 01 00 | 0c 00 00 0e 01 c7 0c 01 |........|........|
|00004b10| 00 0e 01 cf 0c 00 00 0e | 02 cf 0c 00 00 0e 03 93 |........|........|
|00004b20| 0c 01 00 0e 03 9c 0c 00 | 00 0e 00 01 0d ff 00 06 |........|........|
|00004b30| 00 00 0c 00 00 0e 00 95 | 70 72 6f 63 65 64 75 72 |........|procedur|
|00004b40| 65 20 4c 65 74 74 65 72 | 73 50 72 6f 6d 70 74 20 |e Letter|sPrompt |
|00004b50| 28 70 72 6f 6d 70 74 2c | 20 61 63 63 65 70 74 65 |(prompt,| accepte|
|00004b60| 64 3a 20 73 74 72 32 35 | 35 3b 20 73 69 7a 65 4c |d: str25|5; sizeL|
|00004b70| 69 6d 69 74 3a 20 69 6e | 74 65 67 65 72 3b 20 61 |imit: in|teger; a|
|00004b80| 75 74 6f 2c 20 77 72 61 | 70 2c 20 63 61 70 69 74 |uto, wra|p, capit|
|00004b90| 61 6c 3a 20 62 6f 6f 6c | 65 61 6e 3b 20 72 65 70 |al: bool|ean; rep|
|00004ba0| 6c 61 63 65 3a 20 63 68 | 61 72 3b 20 74 68 65 52 |lace: ch|ar; theR|
|00004bb0| 6f 75 74 3a 20 50 72 6f | 63 50 74 72 29 3b 20 20 |out: Pro|cPtr);  |
|00004bc0| 7b 73 65 6c 65 63 74 6f | 72 3d 34 7d 0d ff 00 12 |{selecto|r=4}....|
|00004bd0| 00 00 09 01 00 03 00 09 | 09 00 00 03 00 94 0c 00 |........|........|
|00004be0| 00 0e 04 e0 54 68 69 73 | 20 69 73 20 61 20 76 65 |....This| is a ve|
|00004bf0| 72 79 20 63 6f 6d 6d 6f | 6e 20 70 72 6f 6d 70 74 |ry commo|n prompt|
|00004c00| 69 6e 67 20 70 72 6f 63 | 65 64 75 72 65 2c 20 61 |ing proc|edure, a|
|00004c10| 6e 64 20 69 74 20 69 73 | 20 76 65 72 79 20 70 6f |nd it is| very po|
|00004c20| 77 65 72 66 75 6c 2e 20 | 20 49 74 20 69 73 20 65 |werful. | It is e|
|00004c30| 61 73 69 65 72 20 74 68 | 61 6e 20 66 69 6c 6c 69 |asier th|an filli|
|00004c40| 6e 67 20 61 6c 6c 20 74 | 68 65 20 66 69 65 6c 64 |ng all t|he field|
|00004c50| 73 20 6f 66 20 74 68 65 | 20 70 72 6f 6d 70 74 52 |s of the| promptR|
|00004c60| 65 63 20 79 6f 75 72 73 | 65 6c 66 2c 20 61 6e 64 |ec yours|elf, and|
|00004c70| 20 70 72 6f 76 69 64 65 | 73 20 6d 6f 73 74 20 66 | provide|s most f|
|00004c80| 75 6e 63 74 69 6f 6e 73 | 2e 20 20 54 68 65 20 70 |unctions|.  The p|
|00004c90| 72 6f 6d 70 74 20 66 69 | 65 6c 64 20 69 73 20 74 |rompt fi|eld is t|
|00004ca0| 68 65 20 74 65 78 74 20 | 6f 66 20 79 6f 75 72 20 |he text |of your |
|00004cb0| 70 72 6f 6d 70 74 2e 20 | 20 54 68 65 20 61 63 63 |prompt. | The acc|
|00004cc0| 65 70 74 65 64 20 66 69 | 65 6c 64 20 69 73 20 61 |epted fi|eld is a|
|00004cd0| 20 73 74 72 69 6e 67 20 | 63 6f 6e 74 61 69 6e 69 | string |containi|
|00004ce0| 6e 67 20 65 61 63 68 20 | 63 68 61 72 61 63 74 65 |ng each |characte|
|00004cf0| 72 20 74 68 61 74 20 77 | 69 6c 6c 20 62 65 20 61 |r that w|ill be a|
|00004d00| 6c 6c 6f 77 65 64 20 74 | 6f 20 62 65 20 74 79 70 |llowed t|o be typ|
|00004d10| 65 64 2e 20 20 54 68 69 | 73 20 64 6f 65 73 20 6e |ed.  Thi|s does n|
|00004d20| 6f 74 20 61 70 70 6c 79 | 20 74 6f 20 6e 75 6d 62 |ot apply| to numb|
|00004d30| 65 72 73 2c 20 62 75 74 | 20 64 6f 65 73 20 69 6e |ers, but| does in|
|00004d40| 63 6c 75 64 65 20 65 76 | 65 72 79 20 6f 74 68 65 |clude ev|ery othe|
|00004d50| 72 20 63 68 61 72 61 63 | 74 65 72 20 69 6e 63 6c |r charac|ter incl|
|00004d60| 75 64 69 6e 67 20 2a 26 | 5e 25 24 23 40 21 28 29 |uding *&|^%$#@!()|
|00004d70| d5 d3 2c 20 65 74 63 2e | 2e 2e 20 20 54 68 65 20 |.., etc.|..  The |
|00004d80| 73 69 7a 65 4c 69 6d 69 | 74 20 66 69 65 6c 64 20 |sizeLimi|t field |
|00004d90| 73 70 65 63 69 66 69 65 | 73 20 68 6f 77 20 6d 61 |specifie|s how ma|
|00004da0| 6e 79 20 63 68 61 72 61 | 63 74 65 72 73 20 74 68 |ny chara|cters th|
|00004db0| 65 20 6d 61 78 69 6d 75 | 6d 20 6c 65 6e 67 74 68 |e maximu|m length|
|00004dc0| 20 66 6f 72 20 74 68 65 | 20 70 72 6f 6d 70 74 20 | for the| prompt |
|00004dd0| 69 6e 70 75 74 20 77 69 | 6c 6c 20 62 65 2e 20 20 |input wi|ll be.  |
|00004de0| 54 68 65 20 61 75 74 6f | 20 66 69 65 6c 64 20 69 |The auto| field i|
|00004df0| 6e 64 69 63 61 74 65 73 | 20 77 68 65 74 68 65 72 |ndicates| whether|
|00004e00| 20 48 65 72 6d 65 73 20 | 73 68 6f 75 6c 64 20 61 | Hermes |should a|
|00004e10| 75 74 6f 2d 61 63 63 65 | 70 74 20 69 6e 70 75 74 |uto-acce|pt input|
|00004e20| 20 77 68 65 6e 20 69 74 | 20 64 65 65 6d 73 20 69 | when it| deems i|
|00004e30| 74 20 61 63 63 70 65 74 | 61 62 6c 65 2e 20 20 49 |t accpet|able.  I|
|00004e40| 66 20 74 68 65 20 77 72 | 61 70 20 66 69 65 6c 64 |f the wr|ap field|
|00004e50| 20 69 73 20 74 72 75 65 | 2c 20 74 68 65 20 70 72 | is true|, the pr|
|00004e60| 6f 6d 70 74 20 77 69 6c | 6c 20 68 61 76 65 20 77 |ompt wil|l have w|
|00004e70| 6f 72 64 2d 77 72 61 70 | 70 69 6e 67 20 61 62 69 |ord-wrap|ping abi|
|00004e80| 6c 69 74 69 65 73 2e 20 | 20 54 68 65 20 77 72 61 |lities. | The wra|
|00004e90| 70 70 65 64 20 74 65 78 | 74 20 77 69 6c 6c 20 62 |pped tex|t will b|
|00004ea0| 65 20 70 6c 61 63 65 64 | 20 69 6e 20 74 68 65 20 |e placed| in the |
|00004eb0| 6e 6f 64 65 20 76 61 72 | 69 61 62 6c 65 20 65 78 |node var|iable ex|
|00004ec0| 63 65 73 73 2e 20 20 59 | 6f 75 20 6d 75 73 74 20 |cess.  Y|ou must |
|00004ed0| 74 68 65 6e 20 6f 75 74 | 70 75 74 20 74 68 61 74 |then out|put that|
|00004ee0| 20 76 61 72 69 61 62 6c | 65 20 77 68 65 6e 20 48 | variabl|e when H|
|00004ef0| 65 72 6d 65 73 20 63 61 | 6c 6c 73 20 79 6f 75 20 |ermes ca|lls you |
|00004f00| 61 67 61 69 6e 20 74 6f | 20 65 66 66 65 63 74 20 |again to| effect |
|00004f10| 74 68 65 20 61 63 74 75 | 61 6c 20 77 72 61 70 70 |the actu|al wrapp|
|00004f20| 69 6e 67 2e 20 20 54 68 | 65 20 63 61 70 69 74 61 |ing.  Th|e capita|
|00004f30| 6c 20 66 69 65 6c 64 20 | 73 65 74 20 74 6f 20 74 |l field |set to t|
|00004f40| 72 75 65 20 77 69 6c 6c | 20 63 61 75 73 65 20 61 |rue will| cause a|
|00004f50| 6c 6c 20 6c 65 74 74 65 | 72 73 20 74 79 70 65 64 |ll lette|rs typed|
|00004f60| 20 74 6f 20 74 68 65 20 | 70 72 6f 6d 70 74 20 74 | to the |prompt t|
|00004f70| 6f 20 62 65 20 63 61 70 | 69 74 61 6c 69 7a 65 64 |o be cap|italized|
|00004f80| 20 62 65 66 6f 72 65 20 | 62 65 69 6e 67 20 70 72 | before |being pr|
|00004f90| 6f 63 65 73 73 65 64 2e | 20 20 54 68 65 20 72 65 |ocessed.|  The re|
|00004fa0| 70 6c 61 63 65 20 66 69 | 65 6c 64 20 69 73 20 66 |place fi|eld is f|
|00004fb0| 6f 72 20 68 69 64 64 65 | 6e 20 65 6e 74 72 79 20 |or hidde|n entry |
|00004fc0| 74 79 70 65 20 70 72 6f | 6d 70 74 73 20 6c 69 6b |type pro|mpts lik|
|00004fd0| 65 20 65 6e 74 65 72 69 | 6e 67 20 70 61 73 73 77 |e enteri|ng passw|
|00004fe0| 6f 72 64 73 20 77 68 65 | 72 65 20 74 68 65 20 73 |ords whe|re the s|
|00004ff0| 63 72 65 65 6e 20 73 68 | 6f 75 6c 64 20 73 68 6f |creen sh|ould sho|
|00005000| 77 20 63 68 61 72 61 63 | 74 65 72 73 20 64 69 66 |w charac|ters dif|
|00005010| 66 65 72 65 6e 74 20 66 | 72 6f 6d 20 77 68 61 74 |ferent f|rom what|
|00005020| 20 69 73 20 65 6e 74 65 | 72 65 64 2e 20 20 57 68 | is ente|red.  Wh|
|00005030| 61 74 65 76 65 72 20 74 | 68 69 73 20 63 68 61 72 |atever t|his char|
|00005040| 61 63 74 65 72 20 69 73 | 20 77 69 6c 6c 20 72 65 |acter is| will re|
|00005050| 70 6c 61 63 65 20 61 6c | 6c 20 69 6e 70 75 74 20 |place al|l input |
|00005060| 6f 6e 20 74 68 65 20 72 | 65 6d 6f 74 65 20 61 6e |on the r|emote an|
|00005070| 64 20 6c 6f 63 61 6c 20 | 73 63 72 65 65 6e 73 2e |d local |screens.|
|00005080| 20 20 42 75 74 20 74 68 | 65 20 63 75 72 50 72 6f |  But th|e curPro|
|00005090| 6d 70 74 20 76 61 72 69 | 61 62 6c 65 20 77 69 6c |mpt vari|able wil|
|000050a0| 6c 20 73 74 69 6c 6c 20 | 63 6f 6e 74 61 69 6e 20 |l still |contain |
|000050b0| 74 68 65 20 61 63 63 75 | 72 61 74 65 20 65 6e 74 |the accu|rate ent|
|000050c0| 72 79 2e 0d 00 72 00 00 | 0c 00 00 0e 00 ab 0c 01 |ry...r..|........|
|000050d0| 00 0e 00 b1 0c 00 00 0e | 00 d9 0c 01 00 0e 00 e1 |........|........|
|000050e0| 0c 00 00 0e 01 9c 0c 01 | 00 0e 01 a5 0c 00 00 0e |........|........|
|000050f0| 02 00 0c 01 00 0e 02 04 | 0c 00 00 0e 02 62 0c 01 |........|.....b..|
|00005100| 00 0e 02 66 0c 00 00 0e | 02 da 0c 01 00 0e 02 e0 |...f....|........|
|00005110| 0c 00 00 0e 03 46 0c 01 | 00 0e 03 4d 0c 00 00 0e |.....F..|...M....|
|00005120| 03 ba 0c 01 00 0e 03 c1 | 0c 00 00 0e 04 a6 0c 01 |........|........|
|00005130| 00 0e 04 af 0c 00 00 0e | 00 01 0d ff 00 06 00 00 |........|........|
|00005140| 0c 00 00 0e 00 68 70 72 | 6f 63 65 64 75 72 65 20 |.....hpr|ocedure |
|00005150| 4e 75 6d 62 65 72 73 50 | 72 6f 6d 70 74 20 28 70 |NumbersP|rompt (p|
|00005160| 72 6f 6d 70 74 2c 20 61 | 63 63 65 70 74 65 64 3a |rompt, a|ccepted:|
|00005170| 20 53 54 52 32 35 35 3b | 20 68 69 67 68 2c 20 6c | STR255;| high, l|
|00005180| 6f 77 3a 20 69 6e 74 65 | 67 65 72 3b 20 74 68 65 |ow: inte|ger; the|
|00005190| 52 6f 75 74 3a 20 50 72 | 6f 63 50 74 72 29 3b 20 |Rout: Pr|ocPtr); |
|000051a0| 20 7b 73 65 6c 65 63 74 | 6f 72 3d 35 7d 0d 00 0c | {select|or=5}...|
|000051b0| 00 00 09 01 00 03 00 09 | 09 00 00 03 03 2d 49 66 |........|.....-If|
|000051c0| 20 79 6f 75 72 20 70 72 | 6f 6d 70 74 20 69 73 20 | your pr|ompt is |
|000051d0| 6e 75 6d 62 65 72 2d 62 | 61 73 65 64 2c 20 79 6f |number-b|ased, yo|
|000051e0| 75 20 73 68 6f 75 6c 64 | 20 75 73 65 20 74 68 65 |u should| use the|
|000051f0| 20 4e 75 6d 62 65 72 73 | 50 72 6f 6d 70 74 20 70 | Numbers|Prompt p|
|00005200| 72 6f 63 65 64 75 72 65 | 20 69 6e 73 74 65 61 64 |rocedure| instead|
|00005210| 2e 20 20 45 76 65 6e 20 | 69 66 20 79 6f 75 72 20 |.  Even |if your |
|00005220| 70 72 6f 6d 70 74 20 61 | 63 63 65 70 74 73 20 73 |prompt a|ccepts s|
|00005230| 6f 6d 65 20 63 68 61 72 | 61 63 74 65 72 73 2c 20 |ome char|acters, |
|00005240| 4e 75 6d 62 65 72 73 50 | 72 6f 6d 70 74 20 69 73 |NumbersP|rompt is|
|00005250| 20 6f 66 74 65 6e 20 6d | 6f 72 65 20 61 70 70 72 | often m|ore appr|
|00005260| 6f 70 72 69 61 74 65 2e | 20 20 54 68 65 20 70 72 |opriate.|  The pr|
|00005270| 6f 6d 70 74 20 66 69 65 | 6c 64 20 69 73 20 74 68 |ompt fie|ld is th|
|00005280| 65 20 74 65 78 74 20 6f | 66 20 79 6f 75 72 20 70 |e text o|f your p|
|00005290| 72 6f 6d 70 74 2e 20 20 | 54 68 65 20 61 63 63 65 |rompt.  |The acce|
|000052a0| 70 74 65 64 20 66 69 65 | 6c 64 20 69 73 20 61 20 |pted fie|ld is a |
|000052b0| 73 74 72 69 6e 67 20 63 | 6f 6e 74 61 69 6e 69 6e |string c|ontainin|
|000052c0| 67 20 74 68 65 20 63 68 | 61 72 61 63 74 65 72 73 |g the ch|aracters|
|000052d0| 20 61 6c 6c 6f 77 65 64 | 20 74 6f 20 62 65 20 74 | allowed| to be t|
|000052e0| 79 70 65 64 2e 20 20 49 | 66 20 74 68 69 73 20 69 |yped.  I|f this i|
|000052f0| 73 20 61 6e 20 65 6d 70 | 74 79 20 73 74 72 69 6e |s an emp|ty strin|
|00005300| 67 2c 20 61 6c 6c 20 63 | 68 61 72 61 63 74 65 72 |g, all c|haracter|
|00005310| 73 20 61 72 65 20 61 6c | 6c 6f 77 65 64 2e 20 20 |s are al|lowed.  |
|00005320| 54 68 65 20 68 69 67 68 | 20 66 69 65 6c 64 20 69 |The high| field i|
|00005330| 73 20 74 68 65 20 6d 61 | 78 69 6d 75 6d 20 6e 75 |s the ma|ximum nu|
|00005340| 6d 65 72 69 63 61 6c 20 | 76 61 6c 75 65 20 74 68 |merical |value th|
|00005350| 69 73 20 66 69 65 6c 64 | 20 6d 61 79 20 72 65 74 |is field| may ret|
|00005360| 75 72 6e 2e 20 20 48 65 | 72 6d 65 73 20 77 69 6c |urn.  He|rmes wil|
|00005370| 6c 20 65 6e 66 6f 72 63 | 65 20 74 68 69 73 20 61 |l enforc|e this a|
|00005380| 74 20 74 68 65 20 70 72 | 6f 6d 70 74 2e 20 20 54 |t the pr|ompt.  T|
|00005390| 68 65 20 6c 6f 77 20 66 | 69 65 6c 64 20 63 61 6e |he low f|ield can|
|000053a0| 20 62 65 20 65 69 74 68 | 65 72 20 30 20 6f 72 20 | be eith|er 0 or |
|000053b0| 31 20 64 65 70 65 6e 64 | 69 6e 67 20 6f 6e 20 77 |1 depend|ing on w|
|000053c0| 68 61 74 20 79 6f 75 20 | 77 61 6e 74 2e 20 20 53 |hat you |want.  S|
|000053d0| 65 74 74 69 6e 67 20 68 | 69 67 68 20 6c 6f 77 65 |etting h|igh lowe|
|000053e0| 72 20 74 68 61 6e 20 6c | 6f 77 20 77 69 6c 6c 20 |r than l|ow will |
|000053f0| 63 61 75 73 65 20 61 6c | 6c 20 6e 75 6d 65 72 69 |cause al|l numeri|
|00005400| 63 61 6c 20 69 6e 70 75 | 74 20 74 6f 20 62 65 20 |cal inpu|t to be |
|00005410| 64 69 73 61 6c 6c 6f 77 | 65 64 2e 20 20 49 66 20 |disallow|ed.  If |
|00005420| 6e 75 6d 65 72 69 63 61 | 6c 20 69 6e 70 75 74 20 |numerica|l input |
|00005430| 68 61 73 20 62 65 65 6e | 20 65 6e 74 65 72 65 64 |has been| entered|
|00005440| 2c 20 69 74 20 77 69 6c | 6c 20 62 65 20 72 65 74 |, it wil|l be ret|
|00005450| 75 72 6e 65 64 20 69 6e | 20 74 68 65 20 63 75 72 |urned in| the cur|
|00005460| 50 72 6f 6d 70 74 20 73 | 74 72 69 6e 67 20 61 73 |Prompt s|tring as|
|00005470| 20 77 69 74 68 20 61 6c | 6c 20 6f 74 68 65 72 20 | with al|l other |
|00005480| 70 72 6f 6d 70 74 20 61 | 6e 64 20 79 6f 75 20 73 |prompt a|nd you s|
|00005490| 68 6f 75 6c 64 20 74 68 | 65 6e 20 75 73 65 20 74 |hould th|en use t|
|000054a0| 68 65 20 74 6f 6f 6c 62 | 6f 78 20 70 72 6f 63 65 |he toolb|ox proce|
|000054b0| 64 75 72 65 20 53 74 72 | 69 6e 67 54 6f 4e 75 6d |dure Str|ingToNum|
|000054c0| 20 74 6f 20 63 6f 6e 76 | 65 72 74 20 69 74 20 74 | to conv|ert it t|
|000054d0| 6f 20 61 20 6e 75 6d 62 | 65 72 20 69 66 20 6e 65 |o a numb|er if ne|
|000054e0| 63 65 73 73 61 72 79 2e | 20 20 0d ff 00 42 00 00 |cessary.|  ...B..|
|000054f0| 0c 00 00 0e 00 b0 0c 01 | 00 0e 00 b6 0c 00 00 0e |........|........|
|00005500| 00 de 0c 01 00 0e 00 e6 | 0c 00 00 0e 01 66 0c 01 |........|.....f..|
|00005510| 00 0e 01 6a 0c 00 00 0e | 01 d5 0c 01 00 0e 01 d8 |...j....|........|
|00005520| 0c 00 00 0e 02 9f 0c 01 | 00 0e 02 a8 0c 00 00 0e |........|........|
|00005530| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 61 70 72 |........|.....apr|
|00005540| 6f 63 65 64 75 72 65 20 | 59 65 73 4e 6f 51 75 65 |ocedure |YesNoQue|
|00005550| 73 74 69 6f 6e 20 28 70 | 72 6f 6d 70 74 3a 20 53 |stion (p|rompt: S|
|00005560| 54 52 32 35 35 3b 20 79 | 65 73 49 73 44 65 66 61 |TR255; y|esIsDefa|
|00005570| 75 6c 74 3a 20 62 6f 6f | 6c 65 61 6e 3b 20 74 68 |ult: boo|lean; th|
|00005580| 65 52 6f 75 74 3a 20 50 | 72 6f 63 50 74 72 29 3b |eRout: P|rocPtr);|
|00005590| 20 20 7b 73 65 6c 65 63 | 74 6f 72 3d 36 7d 0d ff |  {selec|tor=6}..|
|000055a0| 00 12 00 00 09 01 00 03 | 00 09 09 00 00 03 00 60 |........|.......`|
|000055b0| 0c 00 00 0e 01 0f 54 68 | 69 73 20 70 72 6f 6d 70 |......Th|is promp|
|000055c0| 74 20 69 73 20 66 6f 72 | 20 73 74 61 6e 64 61 72 |t is for| standar|
|000055d0| 64 20 79 65 73 2f 6e 6f | 20 71 75 65 73 74 69 6f |d yes/no| questio|
|000055e0| 6e 73 2e 20 20 54 68 65 | 20 70 72 6f 6d 70 74 20 |ns.  The| prompt |
|000055f0| 66 69 65 6c 64 20 61 63 | 74 73 20 6c 69 6b 65 20 |field ac|ts like |
|00005600| 69 74 20 64 6f 65 73 20 | 77 69 74 68 20 74 68 65 |it does |with the|
|00005610| 20 6f 74 68 65 72 20 70 | 72 6f 6d 70 74 73 2e 20 | other p|rompts. |
|00005620| 20 54 68 65 20 79 65 73 | 49 73 44 65 66 61 75 6c | The yes|IsDefaul|
|00005630| 74 20 66 69 65 6c 64 20 | 63 6f 6e 74 72 6f 6c 73 |t field |controls|
|00005640| 20 77 68 61 74 20 68 61 | 70 70 65 6e 73 20 77 68 | what ha|ppens wh|
|00005650| 65 6e 20 61 20 72 65 74 | 75 72 6e 20 69 73 20 70 |en a ret|urn is p|
|00005660| 72 65 73 73 65 64 2e 20 | 20 49 66 20 74 68 69 73 |ressed. | If this|
|00005670| 20 66 69 65 6c 64 20 69 | 73 20 74 72 75 65 2c 20 | field i|s true, |
|00005680| 61 20 72 65 74 75 72 6e | 20 77 69 6c 6c 20 63 61 |a return| will ca|
|00005690| 75 73 65 20 61 20 79 65 | 73 20 61 6e 73 77 65 72 |use a ye|s answer|
|000056a0| 2c 20 6f 74 68 65 72 77 | 69 73 65 20 69 74 20 77 |, otherw|ise it w|
|000056b0| 69 6c 6c 20 64 65 66 61 | 75 6c 74 20 74 6f 20 6e |ill defa|ult to n|
|000056c0| 6f 2e 20 20 0d ff 00 1e | 00 00 0c 00 00 0e 00 33 |o.  ....|.......3|
|000056d0| 0c 01 00 0e 00 39 0c 00 | 00 0e 00 6f 0c 01 00 0e |.....9..|...o....|
|000056e0| 00 7b 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |.{......|........|
|000056f0| 00 0e 00 33 70 72 6f 63 | 65 64 75 72 65 20 47 6f |...3proc|edure Go|
|00005700| 48 6f 6d 65 20 28 74 68 | 65 52 6f 75 74 3a 20 70 |Home (th|eRout: p|
|00005710| 72 6f 63 50 74 72 29 3b | 20 20 7b 73 65 6c 65 63 |rocPtr);|  {selec|
|00005720| 74 6f 72 3d 37 7d 0d ff | 00 12 00 00 09 01 00 03 |tor=7}..|........|
|00005730| 00 09 09 00 00 03 00 32 | 0c 00 00 0e 01 c7 54 68 |.......2|......Th|
|00005740| 69 73 20 70 72 6f 63 65 | 64 75 72 65 20 69 73 20 |is proce|dure is |
|00005750| 66 6f 72 20 63 6f 6e 76 | 65 6e 69 65 6e 63 65 20 |for conv|enience |
|00005760| 6f 6e 6c 79 2e 20 20 42 | 61 73 69 63 61 6c 6c 79 |only.  B|asically|
|00005770| 2c 20 69 74 20 73 65 74 | 73 20 74 68 65 20 61 70 |, it set|s the ap|
|00005780| 70 72 6f 70 72 69 61 74 | 65 20 76 61 72 69 61 62 |propriat|e variab|
|00005790| 6c 65 73 20 73 6f 20 74 | 68 61 74 20 74 68 65 20 |les so t|hat the |
|000057a0| 63 75 72 72 65 6e 74 20 | 62 6f 61 72 64 20 70 6f |current |board po|
|000057b0| 73 69 74 69 6f 6e 20 69 | 73 20 61 74 20 74 68 65 |sition i|s at the|
|000057c0| 20 6d 61 69 6e 20 6d 65 | 6e 75 2e 20 20 54 68 65 | main me|nu.  The|
|000057d0| 20 69 6e 54 72 61 6e 73 | 66 65 72 20 76 61 72 69 | inTrans|fer vari|
|000057e0| 61 62 6c 65 20 63 6f 6e | 74 72 6f 6c 73 20 77 68 |able con|trols wh|
|000057f0| 65 74 68 65 72 20 74 68 | 69 73 20 69 73 20 74 68 |ether th|is is th|
|00005800| 65 20 74 72 61 6e 73 66 | 65 72 20 6d 61 69 6e 20 |e transf|er main |
|00005810| 6d 65 6e 75 20 6f 72 20 | 74 68 65 20 6e 6f 72 6d |menu or |the norm|
|00005820| 61 6c 20 6d 61 69 6e 20 | 6d 65 6e 75 2e 20 20 54 |al main |menu.  T|
|00005830| 68 69 73 20 70 72 6f 63 | 65 64 75 72 65 20 63 6f |his proc|edure co|
|00005840| 6e 73 69 73 74 73 20 65 | 73 73 65 6e 74 69 61 6c |nsists e|ssential|
|00005850| 6c 79 20 6f 66 20 74 77 | 6f 20 63 6f 6d 6d 61 6e |ly of tw|o comman|
|00005860| 64 73 2e 20 20 42 6f 61 | 72 64 53 65 63 74 69 6f |ds.  Boa|rdSectio|
|00005870| 6e 3a 3d 4d 61 69 6e 4d | 65 6e 75 2c 20 61 6e 64 |n:=MainM|enu, and|
|00005880| 20 4d 61 69 6e 53 74 61 | 67 65 3a 3d 4d 65 6e 75 | MainSta|ge:=Menu|
|00005890| 54 65 78 74 2e 20 20 55 | 73 65 20 74 68 69 73 20 |Text.  U|se this |
|000058a0| 69 66 20 79 6f 75 20 65 | 76 65 72 20 77 61 6e 74 |if you e|ver want|
|000058b0| 20 74 6f 20 65 78 69 74 | 20 6f 75 74 20 6f 66 20 | to exit| out of |
|000058c0| 79 6f 75 72 20 65 78 74 | 65 72 6e 61 6c 20 62 61 |your ext|ernal ba|
|000058d0| 63 6b 20 74 6f 20 74 68 | 65 20 6d 61 69 6e 20 6d |ck to th|e main m|
|000058e0| 65 6e 75 20 69 6e 73 74 | 65 61 64 20 6f 66 20 74 |enu inst|ead of t|
|000058f0| 6f 20 74 68 65 20 65 78 | 74 65 72 6e 61 6c 20 6d |o the ex|ternal m|
|00005900| 65 6e 75 2e 0d ff 00 18 | 00 00 0c 00 00 0e 00 93 |enu.....|........|
|00005910| 0c 01 00 0e 00 9d 0c 00 | 00 0e 01 9d 0c 00 00 0e |........|........|
|00005920| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 48 70 72 |........|.....Hpr|
|00005930| 6f 63 65 64 75 72 65 20 | 42 61 63 6b 53 70 61 63 |ocedure |BackSpac|
|00005940| 65 20 28 68 6f 77 4d 61 | 6e 79 3a 20 69 6e 74 65 |e (howMa|ny: inte|
|00005950| 67 65 72 3b 20 74 68 65 | 52 6f 75 74 3a 20 70 72 |ger; the|Rout: pr|
|00005960| 6f 63 50 74 72 29 3b 20 | 20 7b 73 65 6c 65 63 74 |ocPtr); | {select|
|00005970| 6f 72 3d 38 7d 0d 00 12 | 00 00 09 01 00 03 00 09 |or=8}...|........|
|00005980| 09 00 00 03 00 47 0c 00 | 00 0e 01 08 49 66 20 66 |.....G..|....If f|
|00005990| 6f 72 20 73 6f 6d 65 20 | 72 65 61 73 6f 6e 20 79 |or some |reason y|
|000059a0| 6f 75 20 77 61 6e 74 20 | 74 6f 20 63 61 75 73 65 |ou want |to cause|
|000059b0| 20 61 6e 20 69 6d 6d 65 | 64 69 61 74 65 20 62 61 | an imme|diate ba|
|000059c0| 63 6b 73 70 61 63 69 6e | 67 20 74 68 61 74 20 64 |ckspacin|g that d|
|000059d0| 65 6c 65 74 65 73 20 74 | 68 65 20 70 72 65 76 69 |eletes t|he previ|
|000059e0| 6f 73 75 20 63 68 61 72 | 61 63 74 65 72 20 74 79 |osu char|acter ty|
|000059f0| 70 65 64 2c 20 75 73 65 | 20 74 68 69 73 20 70 72 |ped, use| this pr|
|00005a00| 6f 63 65 64 75 72 65 2e | 20 20 49 74 20 68 61 6e |ocedure.|  It han|
|00005a10| 64 6c 65 73 20 61 6c 6c | 20 64 72 61 77 69 6e 67 |dles all| drawing|
|00005a20| 20 61 6e 64 20 6f 75 74 | 70 75 74 20 74 6f 20 62 | and out|put to b|
|00005a30| 6f 74 68 20 72 65 6d 6f | 74 65 20 61 6e 64 20 6c |oth remo|te and l|
|00005a40| 6f 63 61 6c 20 73 63 72 | 65 65 6e 73 2e 20 20 54 |ocal scr|eens.  T|
|00005a50| 68 65 20 68 6f 77 4d 61 | 6e 79 20 76 61 72 69 61 |he howMa|ny varia|
|00005a60| 62 6c 65 20 77 69 6c 6c | 20 6c 6f 6f 70 20 74 68 |ble will| loop th|
|00005a70| 72 6f 75 67 68 20 74 68 | 69 73 20 70 72 6f 63 65 |rough th|is proce|
|00005a80| 64 75 72 65 20 68 6f 77 | 4d 61 6e 79 20 74 69 6d |dure how|Many tim|
|00005a90| 65 73 2e 0d 00 12 00 00 | 0c 00 00 0e 00 c7 0c 01 |es......|........|
|00005aa0| 00 0e 00 ce 0c 00 00 0e | 00 01 0d ff 00 06 00 00 |........|........|
|00005ab0| 09 00 00 03 00 4c 70 72 | 6f 63 65 64 75 72 65 20 |.....Lpr|ocedure |
|00005ac0| 41 4e 53 49 50 72 6f 6d | 70 74 65 72 20 28 6e 75 |ANSIProm|pter (nu|
|00005ad0| 6d 43 68 61 72 73 3a 20 | 69 6e 74 65 67 65 72 3b |mChars: |integer;|
|00005ae0| 20 74 68 65 52 6f 75 74 | 3a 20 50 72 6f 63 50 74 | theRout|: ProcPt|
|00005af0| 72 29 3b 20 20 7b 73 65 | 6c 65 63 74 6f 72 3d 39 |r);  {se|lector=9|
|00005b00| 7d 0d 00 12 00 00 09 01 | 00 03 00 09 09 00 00 03 |}.......|........|
|00005b10| 00 4b 0c 00 00 0e 01 8c | 54 68 69 73 20 70 72 6f |.K......|This pro|
|00005b20| 63 65 64 75 72 65 20 69 | 73 20 75 73 65 64 20 6f |cedure i|s used o|
|00005b30| 66 74 65 6e 20 69 6e 20 | 48 65 72 6d 65 73 2e 20 |ften in |Hermes. |
|00005b40| 20 49 74 20 75 73 65 73 | 20 74 68 65 20 75 73 65 | It uses| the use|
|00005b50| 72 d5 73 20 41 4e 53 49 | 20 63 6f 6c 6f 72 20 6e |r.s ANSI| color n|
|00005b60| 75 6d 62 65 72 20 34 20 | 77 68 69 63 68 20 64 65 |umber 4 |which de|
|00005b70| 66 61 75 6c 74 73 20 77 | 69 74 68 20 61 20 62 6c |faults w|ith a bl|
|00005b80| 75 65 20 62 61 63 6b 67 | 72 6f 75 6e 64 20 74 6f |ue backg|round to|
|00005b90| 20 64 72 61 77 20 6e 75 | 6d 43 68 61 72 73 20 73 | draw nu|mChars s|
|00005ba0| 70 61 63 65 73 20 77 68 | 69 63 68 20 63 72 65 61 |paces wh|ich crea|
|00005bb0| 74 65 73 20 74 68 65 20 | 65 66 66 65 63 74 20 6f |tes the |effect o|
|00005bc0| 66 20 61 20 73 70 65 63 | 69 61 6c 20 62 61 63 6b |f a spec|ial back|
|00005bd0| 67 72 6f 75 6e 64 20 62 | 65 69 6e 67 20 74 79 70 |ground b|eing typ|
|00005be0| 65 64 20 6f 6e 2e 20 20 | 46 6f 72 20 69 6e 73 74 |ed on.  |For inst|
|00005bf0| 61 6e 63 65 2c 20 74 68 | 69 73 20 69 73 20 75 73 |ance, th|is is us|
|00005c00| 65 64 20 77 68 65 6e 20 | 65 6e 74 65 72 69 6e 67 |ed when |entering|
|00005c10| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 61 20 66 | the nam|e of a f|
|00005c20| 69 6c 65 20 74 6f 20 64 | 6f 77 6e 6c 6f 61 64 20 |ile to d|ownload |
|00005c30| 69 6e 20 48 65 72 6d 65 | 73 2e 20 20 43 61 6c 6c |in Herme|s.  Call|
|00005c40| 20 74 68 69 73 20 69 6d | 6d 65 64 69 61 74 65 6c | this im|mediatel|
|00005c50| 79 20 61 66 74 65 72 20 | 79 6f 75 72 20 70 72 6f |y after |your pro|
|00005c60| 6d 70 74 20 70 72 6f 63 | 65 64 75 72 65 20 61 6e |mpt proc|edure an|
|00005c70| 64 20 74 68 65 6e 20 65 | 78 69 74 20 62 61 63 6b |d then e|xit back|
|00005c80| 20 74 6f 20 48 65 72 6d | 65 73 20 69 66 20 79 6f | to Herm|es if yo|
|00005c90| 75 20 77 61 6e 74 20 74 | 68 69 73 20 65 66 66 65 |u want t|his effe|
|00005ca0| 63 74 2e 0d 00 18 00 00 | 0c 00 00 0e 00 7e 0c 01 |ct......|.....~..|
|00005cb0| 00 0e 00 86 0c 00 00 0e | 01 86 0c 00 00 0e 00 01 |........|........|
|00005cc0| 0d ff 00 06 00 00 0c 00 | 00 0e 00 7c 66 75 6e 63 |........|...|func|
|00005cd0| 74 69 6f 6e 20 52 65 61 | 64 54 65 78 74 46 69 6c |tion Rea|dTextFil|
|00005ce0| 65 20 28 66 69 6c 65 4e | 61 6d 65 3a 20 73 74 72 |e (fileN|ame: str|
|00005cf0| 32 35 35 3b 20 73 74 6f | 72 65 64 41 73 3a 20 69 |255; sto|redAs: i|
|00005d00| 6e 74 65 67 65 72 3b 20 | 69 6e 73 65 72 74 50 61 |nteger; |insertPa|
|00005d10| 74 68 3a 20 62 6f 6f 6c | 65 61 6e 3b 20 74 68 65 |th: bool|ean; the|
|00005d20| 52 6f 75 74 3a 20 50 72 | 6f 63 50 74 72 29 3a 20 |Rout: Pr|ocPtr): |
|00005d30| 62 6f 6f 6c 65 61 6e 3b | 20 20 7b 73 65 6c 65 63 |boolean;|  {selec|
|00005d40| 74 6f 72 3d 31 30 7d 0d | 00 12 00 00 09 01 00 03 |tor=10}.|........|
|00005d50| 00 08 09 00 00 03 00 7b | 0c 00 00 0e 02 e9 54 68 |.......{|......Th|
|00005d60| 69 73 20 66 75 6e 63 74 | 69 6f 6e 20 72 65 61 64 |is funct|ion read|
|00005d70| 73 20 61 6c 6c 20 74 65 | 78 74 20 66 69 6c 65 73 |s all te|xt files|
|00005d80| 2e 20 20 54 68 65 20 66 | 69 6c 65 4e 61 6d 65 20 |.  The f|ileName |
|00005d90| 70 61 72 61 6d 65 74 65 | 72 20 65 69 74 68 65 72 |paramete|r either|
|00005da0| 20 63 6f 6e 74 61 69 6e | 73 20 61 20 66 69 6c 65 | contain|s a file|
|00005db0| 20 6e 61 6d 65 20 6f 6e | 20 64 69 73 6b 20 6f 72 | name on| disk or|
|00005dc0| 20 61 20 72 65 73 6f 75 | 72 63 65 20 6e 61 6d 65 | a resou|rce name|
|00005dd0| 20 66 6f 72 20 61 20 48 | 65 72 6d 65 73 20 48 54 | for a H|ermes HT|
|00005de0| 78 74 20 72 65 73 6f 75 | 72 63 65 2e 20 20 54 68 |xt resou|rce.  Th|
|00005df0| 65 20 73 74 6f 72 65 64 | 41 73 20 70 61 72 61 6d |e stored|As param|
|00005e00| 65 74 65 72 20 63 6f 6e | 74 72 6f 6c 73 20 77 68 |eter con|trols wh|
|00005e10| 61 74 20 74 79 70 65 20 | 6f 66 20 74 65 78 74 20 |at type |of text |
|00005e20| 65 6e 74 69 74 79 20 69 | 73 20 62 65 69 6e 67 20 |entity i|s being |
|00005e30| 72 65 61 64 2e 20 20 49 | 66 20 74 68 69 73 20 65 |read.  I|f this e|
|00005e40| 71 75 61 6c 73 20 30 2c | 20 74 68 65 20 66 69 6c |quals 0,| the fil|
|00005e50| 65 6e 61 6d 65 20 72 65 | 66 65 72 73 20 74 6f 20 |ename re|fers to |
|00005e60| 61 20 64 69 73 6b 20 66 | 69 6c 65 2c 20 69 66 20 |a disk f|ile, if |
|00005e70| 69 74 20 65 71 75 61 6c | 73 20 31 20 74 68 65 20 |it equal|s 1 the |
|00005e80| 66 69 6c 65 4e 61 6d 65 | 20 69 73 20 61 20 72 65 |fileName| is a re|
|00005e90| 73 6f 75 72 63 65 20 6f | 66 20 74 79 70 65 20 48 |source o|f type H|
|00005ea0| 54 78 74 2e 20 20 54 68 | 65 20 69 6e 73 65 72 74 |Txt.  Th|e insert|
|00005eb0| 50 61 74 68 20 76 61 72 | 69 61 62 6c 65 20 77 69 |Path var|iable wi|
|00005ec0| 6c 6c 20 69 6e 73 65 72 | 74 20 74 68 65 20 48 65 |ll inser|t the He|
|00005ed0| 72 6d 65 73 20 46 69 6c | 65 73 20 70 61 74 68 20 |rmes Fil|es path |
|00005ee0| 62 65 66 6f 72 65 20 74 | 68 65 20 66 69 6c 65 6e |before t|he filen|
|00005ef0| 61 6d 65 20 66 6f 72 20 | 64 69 73 6b 20 62 61 73 |ame for |disk bas|
|00005f00| 65 64 20 66 69 6c 65 73 | 2e 20 20 49 74 20 68 61 |ed files|.  It ha|
|00005f10| 73 20 6e 6f 20 65 66 66 | 65 63 74 20 77 68 65 6e |s no eff|ect when|
|00005f20| 20 72 65 61 64 69 6e 67 | 20 48 54 78 74 20 72 65 | reading| HTxt re|
|00005f30| 73 6f 75 72 63 65 73 2e | 20 20 57 68 65 6e 20 74 |sources.|  When t|
|00005f40| 68 69 73 20 70 72 6f 63 | 65 64 75 72 65 20 63 6f |his proc|edure co|
|00005f50| 6d 70 6c 65 74 65 73 2c | 20 74 68 65 20 74 65 78 |mpletes,| the tex|
|00005f60| 74 20 69 73 20 72 65 61 | 64 79 20 74 6f 20 62 65 |t is rea|dy to be|
|00005f70| 20 6c 69 73 74 65 64 2e | 20 20 59 6f 75 20 63 61 | listed.|  You ca|
|00005f80| 6e 20 63 61 75 73 65 20 | 74 68 65 20 74 65 78 74 |n cause |the text|
|00005f90| 20 66 69 6c 65 20 74 6f | 20 62 65 20 6c 69 73 74 | file to| be list|
|00005fa0| 65 64 20 74 6f 20 74 68 | 65 20 75 73 65 72 20 62 |ed to th|e user b|
|00005fb0| 79 20 73 65 74 74 69 6e | 67 20 74 68 65 20 42 6f |y settin|g the Bo|
|00005fc0| 61 72 64 41 63 74 69 6f | 6e 20 76 61 72 69 61 62 |ardActio|n variab|
|00005fd0| 6c 65 20 74 6f 20 4c 69 | 73 74 54 65 78 74 2e 20 |le to Li|stText. |
|00005fe0| 20 49 74 20 77 69 6c 6c | 20 74 68 65 6e 20 61 75 | It will| then au|
|00005ff0| 74 6f 6d 61 74 69 63 61 | 6c 6c 79 20 62 65 20 6c |tomatica|lly be l|
|00006000| 69 73 74 65 64 20 6f 75 | 74 2e 20 20 59 6f 75 20 |isted ou|t.  You |
|00006010| 73 68 6f 75 6c 64 20 65 | 78 69 74 20 79 6f 75 72 |should e|xit your|
|00006020| 20 65 78 74 65 72 6e 61 | 6c 20 61 66 74 65 72 20 | externa|l after |
|00006030| 73 65 74 74 69 6e 67 20 | 74 68 61 74 20 76 61 72 |setting |that var|
|00006040| 69 61 62 6c 65 2e 0d ff | 00 3c 00 00 0c 00 00 0e |iable...|.<......|
|00006050| 00 29 0c 01 00 0e 00 31 | 0c 00 00 0e 00 94 0c 01 |.).....1|........|
|00006060| 00 0e 00 9c 0c 00 00 0e | 01 4c 0c 01 00 0e 01 56 |........|.L.....V|
|00006070| 0c 00 00 0e 02 56 0c 00 | 00 0e 02 60 0c 01 00 0e |.....V..|...`....|
|00006080| 02 6b 0c 00 00 0e 00 01 | 0d ff 00 06 00 00 0c 00 |.k......|........|
|00006090| 00 0e 00 3b 70 72 6f 63 | 65 64 75 72 65 20 52 65 |...;proc|edure Re|
|000060a0| 50 72 69 6e 74 50 72 6f | 6d 70 74 20 28 74 68 65 |PrintPro|mpt (the|
|000060b0| 52 6f 75 74 3a 20 50 72 | 6f 63 50 74 72 29 3b 20 |Rout: Pr|ocPtr); |
|000060c0| 20 7b 73 65 6c 65 63 74 | 6f 72 3d 31 31 7d 0d ff | {select|or=11}..|
|000060d0| 00 0c 00 00 09 01 00 03 | 00 09 09 00 00 03 01 03 |........|........|
|000060e0| 49 66 20 66 6f 72 20 73 | 6f 6d 65 20 72 65 61 73 |If for s|ome reas|
|000060f0| 6f 6e 20 79 6f 75 20 68 | 61 64 20 72 65 61 73 6f |on you h|ad reaso|
|00006100| 6e 20 74 6f 20 74 61 6b | 65 20 6f 76 65 72 20 64 |n to tak|e over d|
|00006110| 75 72 69 6e 67 20 61 20 | 70 72 6f 6d 70 74 20 61 |uring a |prompt a|
|00006120| 6e 64 20 77 61 6e 74 20 | 74 6f 20 72 65 73 74 6f |nd want |to resto|
|00006130| 72 65 20 74 68 65 20 73 | 74 61 74 65 20 6f 66 20 |re the s|tate of |
|00006140| 74 68 65 20 73 79 73 74 | 65 6d 2c 20 6a 75 73 74 |the syst|em, just|
|00006150| 20 63 61 6c 6c 20 74 68 | 69 73 20 72 6f 75 74 69 | call th|is routi|
|00006160| 6e 65 2e 20 20 49 74 20 | 68 61 6e 64 6c 65 73 20 |ne.  It |handles |
|00006170| 72 65 70 72 6f 64 75 63 | 74 69 6f 6e 20 6f 66 20 |reproduc|tion of |
|00006180| 74 68 65 20 70 72 6f 6d | 70 74 20 61 6e 64 20 77 |the prom|pt and w|
|00006190| 68 61 74 65 76 65 72 20 | 6d 61 79 20 68 61 76 65 |hatever |may have|
|000061a0| 20 61 6c 72 65 61 64 79 | 20 62 65 65 6e 20 74 79 | already| been ty|
|000061b0| 70 65 64 2e 20 20 49 74 | 20 61 6c 73 6f 20 68 61 |ped.  It| also ha|
|000061c0| 6e 64 6c 65 73 20 74 68 | 65 20 61 70 70 72 6f 70 |ndles th|e approp|
|000061d0| 72 69 61 74 65 20 41 4e | 53 49 20 63 6f 6c 6f 72 |riate AN|SI color|
|000061e0| 73 2e 0d ff 00 0c 00 00 | 0c 00 00 0e 01 00 0c 00 |s.......|........|
|000061f0| 00 0e 00 01 0d ff 00 06 | 00 00 0c 00 00 0e 00 43 |........|.......C|
|00006200| 70 72 6f 63 65 64 75 72 | 65 20 4f 75 74 43 68 72 |procedur|e OutChr|
|00006210| 20 28 74 68 65 43 68 61 | 72 3a 20 63 68 61 72 3b | (theCha|r: char;|
|00006220| 20 74 68 65 52 6f 75 74 | 3a 20 50 72 6f 63 50 74 | theRout|: ProcPt|
|00006230| 72 29 3b 20 20 7b 73 65 | 6c 65 63 74 6f 72 3d 31 |r);  {se|lector=1|
|00006240| 32 7d 0d ff 00 0c 00 00 | 09 01 00 03 00 09 09 00 |2}......|........|
|00006250| 00 03 01 7e 54 68 69 73 | 20 69 73 20 66 6f 72 20 |...~This| is for |
|00006260| 6f 75 74 70 75 74 74 69 | 6e 67 20 61 6c 6c 20 74 |outputti|ng all t|
|00006270| 68 65 20 74 68 69 6e 67 | 73 20 74 68 61 74 20 4f |he thing|s that O|
|00006280| 75 74 4c 69 6e 65 20 64 | 6f 65 73 20 6e 6f 74 20 |utLine d|oes not |
|00006290| 63 6f 76 65 72 2e 20 20 | 42 75 74 20 74 68 69 73 |cover.  |But this|
|000062a0| 20 6f 6e 6c 79 20 61 63 | 63 65 70 74 73 20 6f 6e | only ac|cepts on|
|000062b0| 65 20 63 68 61 72 61 63 | 74 65 72 2e 20 20 42 75 |e charac|ter.  Bu|
|000062c0| 74 20 69 74 20 68 61 73 | 20 6c 6f 74 73 20 6f 66 |t it has| lots of|
|000062d0| 20 73 70 65 63 69 61 6c | 20 66 75 6e 63 74 69 6f | special| functio|
|000062e0| 6e 73 2e 20 20 49 66 20 | 63 61 6c 6c 65 64 20 77 |ns.  If |called w|
|000062f0| 69 74 68 20 41 53 43 49 | 49 20 63 68 61 72 61 63 |ith ASCI|I charac|
|00006300| 74 65 72 20 31 32 2c 20 | 74 68 69 73 20 77 69 6c |ter 12, |this wil|
|00006310| 6c 20 63 6c 65 61 72 20 | 74 68 65 20 73 63 72 65 |l clear |the scre|
|00006320| 65 6e 2e 20 20 49 66 20 | 74 68 65 20 75 73 65 72 |en.  If |the user|
|00006330| 20 69 73 20 75 73 69 6e | 67 20 41 4e 53 49 2c 20 | is usin|g ANSI, |
|00006340| 74 68 69 73 20 63 68 61 | 72 61 63 74 65 72 20 77 |this cha|racter w|
|00006350| 69 6c 6c 20 62 65 20 74 | 72 61 6e 73 6c 61 74 65 |ill be t|ranslate|
|00006360| 64 20 74 6f 20 74 68 65 | 20 41 4e 53 49 20 73 63 |d to the| ANSI sc|
|00006370| 72 65 65 6e 20 63 6c 65 | 61 72 20 63 6f 6d 6d 61 |reen cle|ar comma|
|00006380| 6e 64 2e 20 20 49 66 20 | 63 61 6c 6c 65 64 20 77 |nd.  If |called w|
|00006390| 69 74 68 20 41 53 43 49 | 49 20 63 68 61 72 61 63 |ith ASCI|I charac|
|000063a0| 74 65 72 20 37 2c 20 69 | 74 20 77 69 6c 6c 20 63 |ter 7, i|t will c|
|000063b0| 61 75 73 65 20 74 68 65 | 20 72 65 6d 6f 74 65 20 |ause the| remote |
|000063c0| 63 6f 6d 70 75 74 65 72 | 20 74 6f 20 62 65 65 70 |computer| to beep|
|000063d0| 2e 0d 00 0c 00 00 0c 00 | 00 0e 01 00 0c 00 00 0e |........|........|
|000063e0| 00 01 0d ff 00 06 00 00 | 0c 00 00 0e 00 45 70 72 |........|.....Epr|
|000063f0| 6f 63 65 64 75 72 65 20 | 41 4e 53 49 43 6f 64 65 |ocedure |ANSICode|
+--------+-------------------------+-------------------------+--------+--------+